Measure MapAPI
Help CenterGet an API key

Update a folder

PUT/folders/{fid}
projects:write EnterpriseOpen Guest

Renames a folder, changes its description or members, or moves it into another folder. Only the fields you send change. A folder cannot be moved into itself or into a folder inside it.

By default the members you send are added to the folder's; with mergeMembers=false they replace them.

Path parameters

  • fidstringrequired
    The folder's ID.

Query parameters

  • mergeMembersboolean
    false to replace the members with the ones you send, instead of adding them.
    Defaulttrue

Request body application/json

Fields of ItemUpdate:

  • namestring
    A new name. Not blank.
    at most 200 characters
  • descriptionstring
    at most 5000 characters
  • membersarray of string
    Accounts to add as members (or to keep, with mergeMembers=false).
    at most 100 items
  • parentIdstring
    A folder of yours or your members' to move it into, or root for the top level.

Responses

  • Folder:

    • typestringrequired
      Always"folder"
    • idstringrequired
    • creatorUidstringrequired
      The account that owns the folder.
    • folderIdstringor null
      The folder it is inside; empty or absent at the top level.
    • namestringrequired
    • descriptionstring
    • createdOninteger(int64)required
      When it was created, in milliseconds since 1 January 1970 (UTC).
    • membersarray of string
      The accounts that can open it and the projects filed in it.

Errors

A failed request answers with one of these, in an Error body.

400invalid_bodyA value in the request body is missing, has the wrong type, is too long or is not one of the accepted values.
401unauthorized_actionThe item is not on your account or your members', the request came from a web page on a website the key does not allow, or the action is not allowed for this person.
403insufficient_scopeThe key does not have the access this endpoint needs. Create a key with that access.
403invalid_api_keyNo key was sent in the Authorization header, or the key is unknown, revoked, or past the time it kept working after being replaced.
404not_foundThe folder or product does not exist, or is not in your catalogue.

Try it

This key is

The key stays in this tab and goes only to the API. Use a sandbox key while you try things: requests are real, and what they change is changed.

PUT https://api.measuremaponline.com/api/v1/folders/fld_8Jk2LmQ4

Fill in your API key to send.

As a cURL command
Shell
curl -X PUT 'https://api.measuremaponline.com/api/v1/folders/fld_8Jk2LmQ4' \
  -H "Authorization: $MMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "2026 jobs (archive)",
  "parentId": "root"
}'