agentRunner

Commit an agent run's changes to a branch

Queues a commit of the run's diff to target_branch. The commit is made in the background: merge_commit_is_being_created is true until it finishes. Poll getAgentRunner until merge_commit_sha or merge_commit_error is set.

post/agent_runners/{agent_runner_id}/commit

Request

  • Base URL
    https://api.netlify.com/api/v1
  • URL
    https://api.netlify.com/api/v1/agent_runners/{agent_runner_id}/commit
  • Auth
    OAuth 2
    Implicit: https://app.netlify.com/authorize

Query parameters

target_branchstring required

Response

OK

idstring
site_idstring
parent_agent_runner_idstring
statestring

One of new, running, await_input, interrupted, error, done, cancelled or archived.

created_atstring dateTime
updated_atstring dateTime
done_atstring dateTime
titlestring
branchstring
result_branchstring
pr_urlstring
pr_branchstring
pr_statestring

One of open, draft, merged or closed.

pr_numberinteger
pr_is_being_createdboolean
pr_errorstring
current_taskstring

What the agent is working on in the active session.

result_diffstring
shastring
merge_commit_shastring
merge_commit_errorstring
merge_commit_is_being_createdboolean
base_deploy_idstring
attached_file_keysstring[]
active_session_created_atstring dateTime
has_result_diffboolean

Whether the run has changes, available from GET /agent_runners/{agent_runner_id}/diff.

latest_session_deploy_idstring
latest_session_deploy_urlstring
preview_statestring

State of the deploy building the latest preview. Null until that deploy exists; ready once the preview is live.

Changes

No recorded changes to this operation across all 65 revisions of this API.