List the files the session's pull request changed

GET/o/{org}/p/{project}/sessions/{session}/changes
View .md

Read from the run's GitHub pull request, so it works after the sandbox is gone. A run with no pull request returns an empty list. When GitHub cannot be read, the answer is still 200, with the PR link, no files, and error_code CHANGES_NO_INSTALLATION or CHANGES_LIST_FAILED.

Authenticate with an org API key or a signed-in session.

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

projectstringrequired

A Project's handle (name) or id, resolved inside {org} — OR the reserved sentinel _ meaning "no Project" (a direct-repo / repo-less dispatch on POST; "no Project constraint, resolve by session id alone" everywhere else). A real handle that doesn't match the session's actual Project is 404.

sessionstringrequired

The session's full id (execution_id).

Responses

200The changed files.
pr_urlstring | nullrequired
pr_numberinteger | nullrequired
filesarray of objectrequired
6 item fields
filenamestringrequired
statusstringrequired

GitHub's file status: added, modified, removed, renamed…

additionsintegerrequired
deletionsintegerrequired
changesintegerrequired
patchstringoptional

The unified diff, when GitHub returns one.

totalsobjectrequired
4 fields
filesintegerrequired
additionsintegerrequired
deletionsintegerrequired
changesintegerrequired
errorstringoptional

Present only when the file list could not be read.

error_codestringoptional
One ofCHANGES_NO_INSTALLATIONCHANGES_LIST_FAILED
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one that exists in an org the caller cannot see.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional