---
title: "Share Template"
method: POST
path: "/v1/template/share"
tags: ["templates"]
---

# Share Template

`POST /v1/template/share`

Share a private template (shared-with-link)

## Headers

- `X-Team-Id` string

## Request body

- object
  - `template_id` string, required
  - `share_type` 'unlisted' | 'organization' | 'users', required
  - `ttl` string
  - `organizations` string[]
  - `emails` string[]

## Response `200`

Example response

- object
  - `message` string, required
  - `result` SharedTemplateMetaData, required
    - `expires_at` string, date-time
    - `organizations` string[]
    - `share_type` string
    - `template_id` string
    - `users_email` string[]

## Other responses

- `400` — Example response
- `401` — Example response
- `404` — Example response
- `500` — Example response
- `default` — Example response

## Changes

- **2025-08-13** `c41cd7ae7718` — 1 breaking, 11 warning, 4 info
  - added the new required request property `share_type`
  - removed the request property `is_public`
  - removed the optional property `status` from the response with the `200` status
  - removed the optional property `status` from the response with the `400` status
  - …12 more
- **2024-09-22** `407b73d9ce28` — 1 info
  - added the new optional `header` request parameter `X-Team-Id`
- **2024-01-31** `4f557b176ebd` — 3 breaking, 9 info
  - the request property `is_public` became required
  - the request property `template_id` became required
  - removed the success response with the status `201`
  - added the media type `application/json` for the response with the status `500`
  - …8 more
- **2023-12-06** `35be9c1301b7` — 1 info
  - api tag `templates` added
- **2023-12-05** `5c3748c387f7` — 4 breaking, 5 warning, 6 info
  - removed the media type `application/json` for the response with the status `500`
  - removed the required property `message` from the response with the `200` status
  - removed the required property `message` from the response with the `401` status
  - removed the required property `result` from the response with the `200` status
  - …11 more

[Change history](https://skmtc.dev/projectdiscovery/apis/pdcp-api/changes/v1/template/share/post.md)

---

[API](https://skmtc.dev/projectdiscovery/apis/pdcp-api.md) · [All operations](https://skmtc.dev/projectdiscovery/apis/pdcp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/projectdiscovery/pdcp-api/revisions/220f0adf9efd/schema)