Skip to main content
POST
create_pr

Body

application/json

Phase configuration for this action (team.yml shape).

name
string
required

Phase name in team.yml

Example:

"git-create-pr"

agent
enum<string>
required

Must be git

Available options:
git
action
enum<string>
required

Operation to run — create_pr

Available options:
create_pr
project_dir
string

Working tree the PR is opened from (defaults to process.cwd())

base_branch
string

Destination branch for the PR (e.g. 'master', 'develop'). Overrides settings..base_branch and the remote HEAD auto-detect; falls back to 'main' if none is available

notify
object

Pipeline lifecycle events this agent can handle (e.g. on_complete with action: create_pr)

Response

Phase completes successfully. Connector agents write artifacts under .cliq/files/{phase}/ and return structured data / text in the agent result.

ok
enum<boolean>
Available options:
true
text
string

Human-readable summary

data
object

Action-specific result payload