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 code CHANGES_NO_INSTALLATION or CHANGES_LIST_FAILED.

Authenticate with an 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.

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, TOKEN_LIMIT_REACHED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one in an org the caller is not in or a Project that is private to someone else.
errorstringoptional

A sentence for a person.

codestringoptional

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

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
429The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED).

The account is over its request budget, 1,800 a minute shared by the person's API keys and console on every API host (RATE_LIMITED). The error names the limit. Wait Retry-After seconds.

errorstringoptional

A sentence for a person.

codestringoptional

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

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional