---
title: "Create Share Template"
method: POST
path: "/share-templates"
tags: ["Share Templates"]
---

# Create Share Template

`POST /share-templates`

## Request

- Base URL: `https://api.aspect.inc`
- URL: `https://api.aspect.inc/share-templates`
- Auth: API key in header `Authorization`

Create a new share template in a workspace.

## Request body

- ShareTemplateCreateRequest: API request schema for creating a share template
  - `workspace_id` string, uuid, required: Workspace to create the share template in
  - `name` string, required: Display name for the share template
  - `actions` integer, required: Bitmap of allowed actions (VIEW=1, EDIT=2)

## Response `201`

Successful Response

- ShareTemplateResponse: API response schema for a share template
  - `id` string, uuid, required: Share template ID
  - `workspace_id` string, uuid, required: Workspace ID
  - `name` string, required: Display name
  - `actions` integer, required: Allowed actions bitmap
  - `created` string, date-time, required: Creation timestamp
  - `updated` string, date-time, required: Last update timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aspect/apis/aspect-api.md) - [All operations](https://skmtc.dev/aspect/apis/aspect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aspect/apis/aspect-api/revisions/28ea5f1adb54?raw)