Skip to content
Markdawn Docs

Find Folders By Exact Name

GET
/folders/resolve
curl --request GET \
  --url 'https://markdawn.space/api/v1/folders/resolve?name=example' \
  --header 'Authorization: Bearer <token>'

Returns accessible, non-deleted folders whose names match the name query without regard to case. Each result includes its computed folder path.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
name
required
string
<= 250 characters

Folder name to match. Surrounding whitespace is ignored and matching is case-insensitive.

Responses

Section titled “Responses”

200

Section titled “200”

Accessible folders with matching names and computed folder paths.

Media typeapplication/json
object
data
required
Array<object>
object
id
required
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
parentId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
name
required
string
icon
required
Any of:
string
ownerId
required
Any of:
string format: uuid
/^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$/
permission
required
Any of:
string
Allowed values: view edit admin
createdAt
required
Any of:
string
updatedAt
required
Any of:
string
folderPath
required
string
Example
{
  "data": [
    {
      "permission": "view"
    }
  ]
}

403

Section titled “403”

The API token is missing a required scope: pages:read.

Media typeapplication/json

Structured error returned when the request cannot be completed.

object
error
required

Error details for programmatic handling.

object
code
required

Stable error code.

string
message
required

Human-readable explanation.

string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example"
  }
}