> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.videogen.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.videogen.io/_mcp/server.

# Get editing capabilities

GET https://api.videogen.io/v1/projects/{projectId}/editing-capabilities

Discover the implemented immediate commands and effective write access.

Reference: https://docs.videogen.io/rest-api-reference/projects/get-project-editing-capabilities

## Authentication

- `Authorization` header (bearer token, required) — API key from [app.videogen.io/api](https://app.videogen.io/api). The full key is only shown once when you create it.

## Request

### Path parameters

- `projectId` (string, required)

## Response

### 200

Current authorized result.

- `projectId` (string, required)
- `canEdit` (boolean, required)
- `requiresExplicitVideo` (true, required)
- `commands` (list of ProjectEditingCapabilitiesCommandsItems, required)
- `limits` (ProjectEditingCapabilitiesLimits, required)

## Types

### ProjectEditingCapabilitiesCommandsItems

- `type` (string, required)
- `target` (enum, required)
  - Allowed values: `PROJECT`, `ARTIFACT`, `WORKFLOW`, `EDITABLE_VIDEO`
- `execution` (enum, required)
  - Allowed values: `IMMEDIATE`, `BACKGROUND`

### ProjectEditingCapabilitiesLimits

- `maxCommands` (integer, required)
- `maxBodyBytes` (integer, required)

## Examples

**Response**

```json
{
  "projectId": "string",
  "canEdit": true,
  "requiresExplicitVideo": true,
  "commands": [
    {
      "type": "string",
      "target": "PROJECT",
      "execution": "IMMEDIATE"
    }
  ],
  "limits": {
    "maxCommands": 1,
    "maxBodyBytes": 1
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.videogen.io/v1/projects/projectId/editing-capabilities"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```