Projects

Trigger a dynamic pull request run

View as Markdown

Trigger the dynamic PR agent from CI using PR metadata. Callers do not send changed files; TesterArmy enriches with changed files and GitHub reporting only when the project has a supported GitHub connection.

Authentication

AuthorizationBearer
API key authentication using Bearer token format

Path parameters

projectIdstringRequired
Project ID or shortId

Request

This endpoint expects an object.
objectRequired
OR
objectRequired

Response

Dynamic PR run queued successfully
statusenum

“skipped” means the PR skip judge decided the changes cannot affect this platform; a cancelled audit run records the decision and no test executes.

runIdstringformat: "uuid"
projectIdstringformat: "uuid"
platformenum
skipReasonstringOptional
Present only when status is "skipped".
metadataobjectOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
413
Content Too Large Error
429
Too Many Requests Error
500
Internal Server Error
504
Gateway Timeout Error