Trigger a dynamic pull request run | TesterArmy: Documentation

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

Response

Dynamic PR run queued successfully

statusenum

runIdstringformat: "uuid"

projectIdstringformat: "uuid"

platformenum

metadataobject

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

$	curl -X POST https://tester.army/api/v1/projects/projectId/pull-request-runs \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"targetUrl": "string",
>	"pullRequest": {
>	"number": 1,
>	"title": "string",
>	"commitSha": "string"
>	}
>	}'

1	{
2	"status": "queued",
3	"runId": "string",
4	"projectId": "string",
5	"platform": "web",
6	"metadata": {
7	"github": {
8	"configured": true,
9	"checkRunCreated": true,
10	"commentTargetResolved": true,
11	"status": "not_configured"
12	},
13	"mobile": {
14	"source": "string",
15	"buildId": "string"
16	}
17	}
18	}