Skip to main content

​
CLI

CommandUse
deepline auth registerConnect this machine
deepline auth status --jsonConfirm host, user, and workspace
deepline org listSee available workspaces
deepline org switch <name>Switch interactively
deepline plays search <query> --jsonFind prebuilt and saved plays
deepline plays describe <name> --jsonInspect inputs and outputs
deepline plays check <file>Validate a play without running it
deepline plays run <target> --watchRun a file or named play
deepline plays publish <file>Save and activate a play revision

​
Config

NameUse
DEEPLINE_API_KEYWorkspace API key
DEEPLINE_HOST_URLDeepline host override
.env.deeplinePer-workspace file containing only DEEPLINE_HOST_URL and DEEPLINE_API_KEY
For automation, put DEEPLINE_HOST_URL and DEEPLINE_API_KEY in the workspace folder’s .env.deepline, then run plain deepline ... commands from that folder.

​
Input size limits

Input sizeBehavior
Up to 100 KBStored inline in coordinator retry state
100 KB to 1 MiBStored as a short-lived artifact-backed retry payload
Over 1 MiBRejected; use staged files or ctx.csv inputs
Play input should contain parameters, filters, and file references. For large tables, lead lists, research corpora, or documents, pass a file path and read it inside the play with ctx.csv(input.csv) or the relevant file reader.

​
Bindings

import { definePlay } from 'deepline';

export default definePlay('inbound', async (_ctx, input: { email: string }) => {
  return { email: input.email };
}, {
  webhook: {},
});

import { definePlay } from 'deepline';

export default definePlay('daily', async () => {
  return { ok: true };
}, {
  cron: { schedule: '0 9 * * *', timezone: 'America/New_York' },
});

import { definePlay } from 'deepline';

export default definePlay('capped', async () => {
  return { ok: true };
}, {
  billing: { maxCreditsPerRun: 25 },
});

​
Common fixes

SymptomTry
Missing API keydeepline auth register or add DEEPLINE_API_KEY to .env.deepline
Wrong workspacedeepline auth status --json
Play syntax failsdeepline plays check <file>
Prebuilt called as a toolUse deepline plays run or ctx.runPlay
Background job used wrong orgRun from the folder with the correct .env.deepline