---
title: "Share folder"
method: POST
path: "/api/v1/folders/share/{id}/"
tags: ["Folders"]
---

# Share folder

`POST /api/v1/folders/share/{id}/`

## Request

- Base URL: `https://plagiarismcheck.org`
- URL: `https://plagiarismcheck.org/api/v1/folders/share/{id}/`
- Auth: API key in header `X-API-TOKEN`

Share a folder with another group member.

## Request body `application/x-www-form-urlencoded`

- object: Endpoint-specific form fields handled by the controller.

## Response `201`

The resource was created successfully.

- GenericSuccessResponse: Generic success envelope used for endpoints whose data shape is endpoint-specific.
  - `success` boolean
  - `data` union: Endpoint-specific response data.
    - object, nullable
    - object[], nullable
    - string, nullable
    - integer, nullable
    - boolean, nullable
  - `message` string, nullable: Optional informational message returned by some endpoints.

## Other responses

- `400`: The request is invalid. Check required fields, field formats, and resource ownership.
- `403`: Authentication or authorization failed because the token is missing, invalid, blocked, or not allowed to access the resource.

---

[API](https://skmtc.dev/plagiarismcheck/apis/plagiarismcheck-org-api.md) - [All operations](https://skmtc.dev/plagiarismcheck/apis/plagiarismcheck-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/plagiarismcheck/apis/plagiarismcheck-org-api/revisions/2c81c29267dc?raw)