Project Manage Tool
project_manageManage project lifecycles and schedules for recurring or one-shot workflow runs. Create, update, activate, or archive projects, and trigger runs immediately.
Instructions
Projects — recurring (continuous) or one-shot containers that schedule workflow runs against goals. Continuous projects spawn ProjectRuns on the configured cadence (cron-style or natural language); one-shot projects fire once on trigger_run. Lifecycle states: draft → active → (paused | archived). Each run reserves budget independently.
Actions:
list / get (read).
create (write) — name, type (one_shot | continuous), workflow_id.
update (write) — project_id + any creatable field.
activate / pause / resume / restart (write) — project_id. Lifecycle transitions.
trigger_run (write — costs credits) — project_id. Dispatches a single run immediately.
archive (write) — project_id. Stops scheduling and hides from default lists; reversible via
restart.schedule (write) — project_id, frequency or cron expression.
schedule_nlp (write) — project_id, natural language schedule (e.g. "every weekday at 9am"). Calls LLM, costs credits.
run_list (read) — project_id; optional limit, status filter.
run_get (read) — project_id, run_id.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list, get, create, update, activate, pause, resume, restart, trigger_run, archive, schedule, schedule_nlp, run_list, run_get | |
| deadline_ms | No | Optional: max wall-clock time (ms) the tool may spend. If exceeded during the call, returns a DEADLINE_EXCEEDED error. Minimum 100 ms. Leave unset for no deadline. | |
| status | No | Filter by status: draft, active, paused, completed, archived, failed | |
| type | No | Filter by type: one_shot, continuous | |
| limit | No | Max results to return (default 10, max 100) | |
| project_id | Yes | The project UUID | |
| title | Yes | Project title | |
| description | No | Project description | |
| goal | No | Project goal | |
| execution_mode | No | Execution mode: autonomous (full tool access) or watcher (read-only tools only). Default: autonomous | autonomous |
| workflow_id | No | UUID of an active workflow to run for each project execution. The workflow must be in active status. | |
| crew_id | No | UUID of a crew to run for each project execution. Alternative to workflow_id. | |
| allowed_tool_ids | No | Restrict which tools agents can use in this project. Pass an array of tool UUIDs. Empty = all team tools allowed. | |
| allowed_credential_ids | No | Restrict which credentials are available to agents in this project. Pass an array of credential UUIDs. | |
| schedule | No | Schedule configuration. Required for continuous projects — omitting it creates a project that never runs. Use project_schedule_nlp to parse natural language schedules. | |
| operation | Yes | get: read schedule details | update: change schedule settings | enable: turn on the schedule | disable: turn off the schedule | |
| run_id | Yes | The project run UUID |