Median

POST /knowledge/documents/{id}/move

Updated Oct 1, 20261 minute read

Move a document

Which folder, and where on it. folderId: null is the library's top level. order shares one scale with siblings; the midpoint of the new neighbors keeps everything else where it was.

Part of Knowledge.

Parameters

NameInTypeRequiredDescription
idpathstringYesA document id.

Request body

application/json, required.

FieldTypeRequiredDescription
folderIdanyYes
ordernumberYes

Responses

StatusDescription
200Done.
400The request is malformed, and the message names the field.
401The bearer token is missing, revoked, or expired.
404Not one of yours, or not there at all.
429Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits.

200 body

FieldTypeRequiredDescription
okbooleanNo

Example response

{
  "ok": true
}

Example request

curl -X POST https://api.median.sh/v1/knowledge/documents/id/move \
  -H "Authorization: Bearer $BEARER_AUTH"

Still need help?

    Esc