# Create a share link

> Creates a link to a video for people outside the organization, optionally with a password, an expiry or a view limit.

```json
{
  "/videos/{id}/share": {
    "post": {
      "tags": [
        "Videos"
      ],
      "summary": "Create a share link",
      "operationId": "createVideoShare",
      "description": "Creates a link to a video for people outside the organization, optionally with a password, an expiry or a view limit.",
      "security": [
        {
          "bearerAuth": []
        }
      ],
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "description": "Id ID",
          "required": true,
          "schema": {
            "type": "string",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|[fF]{8}-[fF]{4}-[fF]{4}-[fF]{4}-[fF]{12})$",
            "format": "uuid"
          }
        },
        {
          "$ref": "#/components/parameters/IdempotencyKey"
        }
      ],
      "responses": {
        "201": {
          "description": "Created successfully"
        },
        "400": {
          "description": "Invalid request",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Error"
              }
            }
          }
        },
        "401": {
          "description": "Unauthorized",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Error"
              }
            }
          },
          "headers": {
            "WWW-Authenticate": {
              "$ref": "#/components/headers/WWWAuthenticate"
            }
          }
        },
        "404": {
          "description": "Not found",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Error"
              }
            }
          }
        },
        "409": {
          "$ref": "#/components/responses/IdempotencyInProgress"
        },
        "422": {
          "$ref": "#/components/responses/IdempotencyKeyReused"
        },
        "429": {
          "$ref": "#/components/responses/TooManyRequests"
        }
      }
    }
  }
}
```