Move a folder (async)
Header Parameters
Path Parameters
Stable folder ID. Unchanged by rename or move. Unknown, malformed, or cross-tenant → 404 FOLDER_NOT_FOUND.
Body Parameters
Show child attributes
Response
Move queued for async processing. Poll
GET /v2/admin/jobs/{jobId} using data.id (kind: folder.move).
Response Attributes
Show child attributes
Destination reference is malformed or ambiguous.
Response Attributes
Show child attributes
Access token is missing or invalid.
Response Attributes
Show child attributes
Authenticated but not permitted — caller is not an admin/super-admin, or the endpoint's feature permission is off.
Response Attributes
Show child attributes
{folderId} or the destination parentId / parentPath is not visible to this caller (unknown, or in another tenant).
Response Attributes
Show child attributes
The move would nest one sync pair inside another (FOLDER_MOVE_SYNC_PAIR_CONFLICT), the folder changed under the request (FOLDER_CONFLICT; safe to retry), or data.type is not folder.
Response Attributes
Show child attributes
Request Content-Type is not application/vnd.api+json.
Response Attributes
Show child attributes
The move is not allowed — see examples for operation-specific codes.
Response Attributes
Show child attributes
Too many requests; retry later.
Response Attributes
Show child attributes
Unexpected server error.