dcloud ci dispatch start

Run one workflow file now, at a branch or tag, with inputs

IAM ci:StartWorkflowChanges state

A `.github/workflows/` file needs `on: workflow_dispatch`; a `.dcloud/workflows/` file (or `.ews/workflows/`, the earlier name; `.dcloud` wins on a name clash) needs `on.manual`. The file is read at the tip of `ref` (default branch when absent); declared input defaults fill what is not passed. 201 with `{ runId, workflowName, path }`; 409 when the file does not accept a manual start.

Synopsis

dcloud ci dispatch start repoId --path path [flags]

Arguments

  • <repoId>Required

    string

    Also accepted as --repo-id. Constraints: uuid

Flags

  • --pathRequired

    string

    Workflow file, e.g. .github/workflows/ci.yml

    Constraints: 1-500 chars

  • --refOptional

    string

    Branch or tag; the default branch when absent

    Constraints: 1-250 chars

  • --inputsOptional

    map of string

    workflow_dispatch inputs, name → value

    Constraints: key=value

Example

dcloud ci dispatch start repoId --path example

Generated from the API description, the same one the API checks requests against and the CLI is built from.