PATCH/api/v1/page-templates/{template_id}

Update a template

Renames a template, or changes its description or icon (an empty icon clears it). A workspace template: its admins and whoever saved it.

API token required10 per minute per IP

Code samples and Try it

Path parameters

template_idstringRequired
The template's id, from List every template.

Request body

application/json, required

namestring
Up to 200 characters.
descriptionstring
Up to 600 characters.
iconstring
Up to 32 characters.

Responses

200OK.
401No token, or the token is revoked or mistyped.
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.

bash

curl -X PATCH https://api.markdrop.in/api/v1/page-templates/TEMPLATE_ID \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Weekly sync"}'

javascript

const res = await fetch("https://api.markdrop.in/api/v1/page-templates/TEMPLATE_ID", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "Weekly sync"
  }),
});
const data = await res.json();

python

import os

import requests

r = requests.patch(
    "https://api.markdrop.in/api/v1/page-templates/TEMPLATE_ID",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    json={"name": "Weekly sync"},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only, and sent only to the API. Create a token

template_idrequired

name

Show all 3 body fields

Your request

curl -X PATCH https://api.markdrop.in/api/v1/page-templates/TEMPLATE_ID \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Weekly sync"}'

This calls the live API as you. Changes are real.

I understand, send real requests from this page

Tick the box above to send. Or copy the command and run it in a terminal.

Did this page help?