Skip to content

orchestration/runs.create

Type: mutation Module: convex/orchestration/runs.ts

{
orgId: string,
programId: Id<"programs">,
name: string,
scopeType: orchestrationScopeTypeValidator,
sprintId: Id<"sprints"> /* optional */,
workstreamId: Id<"workstreams"> /* optional */,
taskIds: Id<"tasks"> /* optional */[],
repositoryIds: Id<"sourceControlRepositories">[],
branchStrategy: orchestrationBranchStrategyValidator,
branchPattern: string /* optional */,
targetBranch: string,
maxConcurrency: number,
tokenBudget: number,
}

Create a new orchestration run with scope, repository, and branch configuration. @param orgId - Organization ID @param programId - Target program @param name - Run display name @param scopeType - Scope (sprint, workstream, or custom task selection)