PUT/api/v1/workspaces/{workspace_id}/folders/{folder_id}/properties

Set a folder's properties

Replaces a folder's properties, and optionally its views. Members and admins. Pages' values never change: a property you leave out keeps its values, hidden.

API token required60 per minute per IPMCP: set_folder_properties

Guide: Properties and views

Code samples and Try it

Path parameters

workspace_idstringRequired
The workspace's id, from the address of its settings page (markdrop.in/settings/workspaces/<workspace-id>) or from List workspaces.
folder_idstringRequired
The folder's id, from List folders.

Request body

application/json, required

propertiesarray of objectRequired
The whole schema: up to 30 properties, each {name, type, options?} (key optional; made from the name). Types: select, multi_select, person, date, text, link, number and checkbox. Up to 30 items.
viewsarray of object
Also replace the saved views. Up to 20 items.
base_revinteger
The rev you read. If someone changed the schema since, the answer is 409 instead of overwriting it.

Responses

200OK.
401No token, or the token is revoked or mistyped.
409Someone changed the properties since your base_rev.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

curl -X PUT https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/properties \ -H "Authorization: Bearer $MARKDROP_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "properties": [ { "name": "Status", "type": "select", "options": [ "Draft", "Done" ] } ] }'

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/properties", { method: "PUT", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "properties": [ { "name": "Status", "type": "select", "options": [ "Draft", "Done" ] } ] }), }); const data = await res.json();

import os import requests r = requests.put( "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/folders/FOLDER_ID/properties", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={ "properties": [ { "name": "Status", "type": "select", "options": ["Draft", "Done"], }, ], }, ) r.raise_for_status() print(r.json())