n8n-nodes-descript

This project and its documentation were created with Claude Code.

An n8n community node for the Descript API. This node allows you to integrate Descript with any n8n workflow to import media, edit projects with AI, manage jobs, and access published projects.

Features

Job Operations

• Import Media - Import media files into a new or existing Descript project. Optionally waits for import to complete.
• Edit Project with AI - Edit a project using natural language AI prompts. Optionally waits for edit to complete.
• Get Job Status - Check the current status of any job.
• Cancel Job - Cancel a running job.

Published Project Operations

• Get - Retrieve published project metadata by slug.

Status Operations

• Get - Validate your API token and get account info.

Installation

In n8n

1. Go to Settings > Community Nodes
2. Select Install
3. Enter n8n-nodes-descript
4. Agree to the risks and select Install

Manual Installation

cd ~/.n8n/nodes
pnpm install n8n-nodes-descript

Credentials

1. Obtain a Descript personal API token from Descript Settings > Developer
2. In n8n, create new Descript API credentials
3. Enter your API token
4. (Optional) Change the API Base URL for staging environments

Development

Prerequisites

• Node.js >= 22
• pnpm

Setup

cd apps/n8n-integration
pnpm install

Create a .env file with your test credentials:

cp .env.example .env
# Edit .env with your Descript API key

Building

pnpm run build

Testing

# Run unit tests
pnpm test

# Run with watch mode
pnpm run test:watch

Some tests require a real API key:

• API_KEY - Your Descript personal token
• TEST_PROJECT_ID - A valid project ID (for editProject integration tests)

Local Development with n8n

1. Build the package: pnpm run build
2. Link to your local n8n installation:

   cd ~/.n8n/nodes
   pnpm link /path/to/apps/n8n-integration

3. Restart n8n to pick up the new node

Publishing to npm

pnpm run build
npm publish

API Reference

The Descript API URL is configurable in the credentials:

• Production: https://descriptapi.com/v1
• Staging: https://staging-api.descript.com/public/v1

Endpoints Used

| Endpoint | Operation | |----------|-----------| | GET /status | Get Status | | POST /jobs/import/project_media | Import Media | | POST /jobs/agent | Edit Project with AI | | GET /jobs/{job_id} | Get Job Status (+ polling) | | DELETE /jobs/{job_id} | Cancel Job | | GET /published_projects/{slug} | Get Published Project |

Async Job Handling

Import Media and Edit Project operations create asynchronous jobs. By default, the node polls GET /jobs/{job_id} until the job completes. You can configure:

• Wait for Completion - Toggle polling on/off
• Poll Interval - How often to check (default: 5 seconds)
• Timeout - Maximum wait time (default: 600 seconds)

License

MIT - Descript, Inc.