---
title: "Update secure space or folder"
method: POST
path: "/api/1/folders/{userFolder}/update"
tags: ["Secure spaces & folders"]
---

# Update secure space or folder

`POST /api/1/folders/{userFolder}/update`

## Request body

- object
  - `name` string — Must not be greater than 255 characters.
  - `client_space` boolean
  - `secure_space` boolean
  - `IncreasedSecurity` boolean
  - `readonly_messages` boolean
  - `scope` 'private' | 'public', nullable
  - `expires_at` string, nullable — Must be a valid date.
  - `files_sort` '!name' | 'name' | 'date' | '!date', nullable
  - `expiry_interval` integer, nullable
  - `messages_mode` string, nullable
  - `color` string, nullable
  - `defaults` object — Defaults.
    - `file` object
      - `properties` string[]
    - `commented` object
      - `properties` string[]

## 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)