Method: projects.testMatrices.create

Creates and runs a matrix of tests according to the given specifications. Unsupported environments will be returned in the state UNSUPPORTED. Matrices are limited to at most 200 supported executions.

May return any of the following canonical error codes:

  • PERMISSION_DENIED - if the user is not authorized to write to project
  • INVALID_ARGUMENT - if the request is malformed or if the matrix expands to more than 200 supported executions

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



The GCE project under which this job will run.

Query parameters



A string id used to detect duplicated requests. Ids are automatically scoped to a project, so users should ensure the ID is unique per-project. A UUID is recommended.

Optional, but strongly recommended.

Request body

The request body contains an instance of TestMatrix.

Response body

If successful, the response body contains a newly created instance of TestMatrix.

Authorization Scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

Try it!