---
title: "Grant an account edit access to a video"
method: POST
path: "/videos/{videoId}/editors"
tags: ["editors"]
---

# Grant an account edit access to a video

`POST /videos/{videoId}/editors`

## Request

- Base URL: `https://api.waymark.com/v1`
- URL: `https://api.waymark.com/v1/videos/{videoId}/editors`
- Auth: one of:
  - API key in header `x-api-key`
  - API key in header `Authorization`

Grant edit access on `videoId` to `editorAccountGuid`. Use `isRevokable` to
control whether the video's owner can remove the grant themselves in the
Waymark app; grants can always be managed through this API.

## Request body

- VideoEditorGrantRequest
  - `editorAccountGuid` string, uuid, required: Account being granted edit access. Must belong to the same partner as the video.
  - `isRevokable` boolean: Whether the video's owner can remove the grant in the Waymark app. Defaults to true. Set to false when your integration manages the grant and the owner should not be able to remove it. Grants can always be removed through this API.

## Response `200`

Existing grant returned (idempotent re-share)

- VideoEditor
  - `guid` string, uuid, required
  - `videoGuid` string, uuid, required
  - `accountGuid` string, uuid, required: Account that has edit access via this grant.
  - `grantedAt` string, date-time, required
  - `isRevokable` boolean, required: Whether the video's owner can remove this grant in the Waymark app.

## Other responses

- `201`: Editor grant created
- `400`: Bad request
- `403`: Forbidden
- `404`: Content not found
- `500`: Internal server error

---

[API](https://skmtc.dev/waymark/apis/waymark-api-v1.md) - [All operations](https://skmtc.dev/waymark/apis/waymark-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/waymark/apis/waymark-api-v1/revisions/0b315115f107?raw)