---
title: "Share secure space"
method: POST
path: "/api/1/folders/{userFolder}/share"
tags: ["Secure spaces & folders"]
---

# Share secure space

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

## Request body

- object
  - `emails` string[], required — Must be a valid email address.
  - `contacts` integer[] — The <code>id</code> of an existing record in the contacts table.
  - `question` string, nullable — This field is required when <code>answer</code> is present.
  - `answer` string, nullable — This field is required when <code>question</code> is present.
  - `body` string, nullable
  - `locale` string
  - `silently` boolean, nullable

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