Create a Suite

Creates a new suite for an existing project. With "Suite" we mean a combination of environment variables and command to be executed. You can test your project against multiple language versions, with custom parameters, or with different environment variables creating an ad-hoc suite. There is no limit in the number of suites you can create.


Both users and collaborators can access this API, via OAuth suites scope (or HTTP Basic Authentication for development purposes).




name Required Human-friendly name of the test suite.
command Required We will execute this command to let your tests start. It can be everything you want, from a bash script to a rake action.
description Optional An arbitrary string which you can attach to the suite.

Example request

$ curl<access_token> \
    -d "name=RSpec Ruby 1.9.2-p290" \
    -d "command=rake spec"
    -d "description=Run RSpec with Ruby 1.9.2-p290" \
    -X POST


The created suite is returned. See Suite Fetch API for fields explanation.

Example response

  "response": {
    "id": 123456789123456789,
    "id_str": "123456789123456789",
    "name": "RSpec Ruby 1.9.2-p290",
    "description": "Run RSpec with Ruby 1.9.2-p290",
    "command": "rake spec"


There are no specific errors for this API.

comments powered by Disqus