API referenceFolders

Move expiries into a folder

posthttps://api.expiryedge.com/v1/moveToFolder
editor or admin60/minAny method
Request
curl -X POST 'https://api.expiryedge.com/v1/moveToFolder' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "expiry_ids": [
    "exp_4Tq9sLm2",
    "exp_9Pd3kWx1"
  ],
  "folder_id": "fld_2Kp9"
}'
Response
{
  "success": true,
  "message": "2 expiries moved successfully",
  "updated_count": 2,
  "failed_count": 0,
  "folder_id": "fld_2Kp9"
}

Moves expiry_ids (max 1000) or a single expiryId into folder_id / folderId (null or omitted = no folder). Ids that are invalid, missing or in another organization are counted in failed_count. Moves expiries only, not folders.

Body parameters

application/json
  • expiry_idsarray of string
    min items: 1 · max items: 1000
  • expiryIdstring
  • folder_idstring | null
  • folderIdstring | null

Returns

200
Move finished.
  • successbooleanrequired
  • messagestringrequired
  • updated_countintegerrequired
  • failed_countintegerrequired
  • folder_idstring | nullrequired

Errors

400
The request is missing required fields or contains invalid values.
401
Missing, expired or invalid bearer token.
403
Authenticated, but your role or organization does not allow this action.
404
The record does not exist or is not in your organization.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.