Move Folder

curl --request PUT \
  --url https://api.tiro.ooo/v1/external/folders/{folderId}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "newParentId": "98765",
  "sharingTypeUpdateStrategy": "KEEP_EXISTING"
}
'

{
  "id": "12345",
  "workspaceGuid": "ws_a1b2c3d4",
  "title": "Weekly Team Meetings",
  "description": "Notes from our weekly sync",
  "sharingType": "ALL_MEMBER_VIEWER",
  "parentId": "98765",
  "color": "#4A90D9",
  "isTeamFolder": true,
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-20T12:00:00Z"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

PUT

external

folders

{folderId}

move

curl --request PUT \
  --url https://api.tiro.ooo/v1/external/folders/{folderId}/move \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "newParentId": "98765",
  "sharingTypeUpdateStrategy": "KEEP_EXISTING"
}
'

{
  "id": "12345",
  "workspaceGuid": "ws_a1b2c3d4",
  "title": "Weekly Team Meetings",
  "description": "Notes from our weekly sync",
  "sharingType": "ALL_MEMBER_VIEWER",
  "parentId": "98765",
  "color": "#4A90D9",
  "isTeamFolder": true,
  "createdAt": "2025-01-15T10:30:00Z",
  "updatedAt": "2025-01-20T12:00:00Z"
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

{
  "error": {
    "code": 404018,
    "errorType": "not_found",
    "message": "No team found for user #217",
    "detail": null
  }
}

인증

Authorization

string

header

필수

API key in format {id}.{secret}.

The notes an endpoint returns depend on the key type. A user key reaches the notes that user can see in the app, including notes in their own private folders. A system key (workspace or organization, no user identity) reaches only notes that sit in a folder shared with all workspace members. Notes in a private folder, in a folder shared with only some members, or in no folder at all fall outside a system key's read scope, and scopes do not widen that boundary.

List and search endpoints drop out-of-scope notes from the response without an error. Single-note reads and their sub-resources return 404, the same response as a deleted note. See What notes a system key reads.

경로 매개변수

folderId

string

필수

Folder ID to move

본문

application/json

Move a folder under a new parent, or to the root level.

newParentId

string | null

Target parent folder ID. Omit or set to null to move the folder to the root level. The target parent must be in the same workspace and you must have access to it.

예시:

"98765"

How the moved folder's sharing permissions are handled.

Strategy	Behavior
`KEEP_EXISTING`	Keep the folder's current `sharingType`.
`INHERIT_FROM_PARENT`	Adopt the new parent folder's `sharingType`.

KEEP_EXISTING: The folder retains its current access control after the move.
INHERIT_FROM_PARENT: The folder adopts its new parent's sharingType and its member list. You must have access to the new parent. Moving to the root level (newParentId: null) has no parent to inherit from, so the folder keeps its existing sharingType.

사용 가능한 옵션:

KEEP_EXISTING,

INHERIT_FROM_PARENT

예시:

"KEEP_EXISTING"

응답

Folder moved

A folder and its metadata.

string

필수

Unique identifier for the folder

예시:

"12345"

workspaceGuid

string

필수

GUID of the workspace the folder belongs to

예시:

"ws_a1b2c3d4"

title

string

필수

Folder title (max 50 characters)

예시:

"Weekly Team Meetings"

description

string

필수

Folder description. Empty string when unset.

예시:

"Notes from our weekly sync"

Who can access a folder and the notes inside it.

Type	View	Edit
`PRIVATE`	Only you	Only you
`ALL_MEMBER_VIEWER`	All workspace members	No member-wide edit access
`ALL_MEMBER_EDITOR`	All workspace members	All workspace members
`LIMITED`	Invited members only	Invited members only (per-member role)

PRIVATE: Personal folder. Not shared with the workspace.
ALL_MEMBER_VIEWER: Every workspace member can view; no member-wide edit access is granted.
ALL_MEMBER_EDITOR: Every workspace member can view and edit.
LIMITED: Only explicitly invited members can access, each with an individual role (VIEWER or EDITOR).

사용 가능한 옵션:

PRIVATE,

ALL_MEMBER_VIEWER,

ALL_MEMBER_EDITOR,

LIMITED

예시:

"PRIVATE"

parentId

string | null

필수

Parent folder ID. null for root-level folders. In the List Folders response, parentId is also null when the parent folder is not accessible to you.

예시:

"12300"

color

string

필수

Folder color in hex format (#RRGGBB)

예시:

"#4A90D9"

isTeamFolder

boolean

필수

true when the folder is shared with the workspace (any sharingType except PRIVATE); false for PRIVATE folders. Retained for backward compatibility — use sharingType for the precise access level.

예시:

true

createdAt

string<date-time>

필수

ISO-8601 creation timestamp (UTC)

예시:

"2025-01-15T10:30:00Z"

updatedAt

string<date-time>

필수

ISO-8601 last-update timestamp (UTC)

예시:

"2025-01-18T14:20:00Z"

Get Folder Path

Reorder Folders

홈

시작하기

API

웹훅

MCP

CLI

개발자 리소스

인증

경로 매개변수

본문

응답