---
title: "Update"
method: PUT
path: "/api/2/folders/{userFolder}"
tags: ["Secure spaces, folders & files"]
---

# Update

`PUT /api/2/folders/{userFolder}`

## Request body

- object
  - `name` string, nullable — Must be at least 1 character. Must not be greater than 255 characters.
  - `secured_space` boolean, nullable — Options.
  - `visibility` 'private' | 'public', nullable
  - `expiry_interval` integer, nullable
  - `expires_at` string, nullable — Must be a valid date.
  - `IncreasedSecurity` boolean, nullable
  - `readonly_messages` boolean, nullable — TODO: find a better key.
  - `messages_mode` string, nullable — TODO: find a better key.
  - `create_folder_policy` 'external' | 'internal', nullable — TODO: find a better key'.
  - `sort` '!name' | 'name' | 'date' | '!date', nullable — Pivot.
  - `color` string, nullable
  - `defaults` object, nullable — Defaults.
    - `file` object
      - `properties` string[]
    - `commented` object
      - `properties` string[]
  - `properties` integer[], required

## Response `200`

- object
  - `ID` integer
  - `@type` string
  - `@id` string
  - `Access` string
  - `Link` string
  - `OriginalLink` string
  - `URL` string
  - `created_at` string
  - `deleted_at` string, nullable
  - `expires_at` string, nullable
  - `updated_at` string
  - `creator` object
    - `ID` integer
    - `@type` string
    - `Title` string, nullable
    - `Name` string
    - `FirstName` string
    - `LastName` string
    - `Avatar` string
    - `Scope` string
    - `HasContact` boolean
  - `Scope` string
  - `Name` string
  - `SecuredSpace` boolean
  - `MessagesMode` integer
  - `CreateFolderPolicy` string, nullable

---

[API](https://skmtc.net/convoflo/apis/convoflo-rest-api.md) · [All operations](https://skmtc.net/convoflo/apis/convoflo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convoflo/convoflo-rest-api/versions/fed4481f0476/schema)