Tests

Make a test

A test's script is each actor's part (cast[].script), or one list of steps each with its role (steps). Every unsaid word (greetings, the agenda line) is filled in when it is saved. Send Idempotency-Key to make a retry safe.

post/v1/apps/{app}/tests

Request

  • Base URL: https://api.taada.dev
  • URL: https://api.taada.dev/v1/apps/{app}/tests
  • Auth: HTTP bearer

Path parameters

appstring required

The app: its id, or its owner/name URL-encoded (modulab%2Fsolivo).

Headers

idempotency-keystring

Request body

namestring required
stepsobject[]
aboutstring
leadstring

The actor who reads the agenda. Defaults to the first, who is always the admin.

agendaLinestring
closingLinestring
record'always' | 'on_failure' | 'never' nullable

Whether a run records: always, only a failure, or never. Null is the default: a saved test records always.

tagsstring[]

The test's tags, replacing the ones it has: each names a part of the app in one lowercase word (companies), or two joined by / (settings/integrations): letters, digits and . _ :, at most one dash in a word, up to 32 characters, at most 20. A ticket id belongs in ref, not a tag. Sent as typed, they are stored lower case with a dash for a space (Release 2.4 is release-2.4). [] removes them all. A check can be started on tags (POST /v1/runs with scope); they never change what a pull request's check runs.

refstring nullable

The id your own tool keeps for this test (your feature or ticket id). Unique among the app's tests: 409 ref_taken when another test has it. Null clears it. Every result names it, so your tool can act on a failure.

Response

Default Response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.