POST/api/v1/workspaces/{workspace_id}/branding/{kind}

Upload a logo or favicon

Uploads an image and returns its URL. It isn't used until you save that URL in the workspace's branding with Update a workspace.

API token required30 per hour per IP

Guide: Branding

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.
kindstringRequired
logo or favicon.

Request body

multipart/form-data, required

filefileRequired

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.

200 response: 2 fields (BrandingAssetResponse)

urlstring
kind"favicon" | "logo"

bash

curl -X POST https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/branding/logo \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -F 'file=@logo.png'

javascript

import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("logo.png")]), "logo.png");

const res = await fetch("https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/branding/logo", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`,
  },
  body: form,
});
const data = await res.json();

python

import os

import requests

r = requests.post(
    "https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/branding/logo",
    headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"},
    files={"file": open("logo.png", "rb")},
)
r.raise_for_status()
print(r.json())

Try it

API token

Kept in this tab only. Without one, the command reads $MARKDROP_TOKEN. Create a token

workspace_idrequired

kindrequired

filerequired

Your request

curl -X POST https://api.markdrop.in/api/v1/workspaces/WORKSPACE_ID/branding/logo \
  -H "Authorization: Bearer $MARKDROP_TOKEN" \
  -F 'file=@FILE'

The API accepts browser requests only from markdrop.in, so this page can’t send it for you. Run the command in a terminal.

Did this page help?