Find 'AutomationTestRun' entities using the specified (body) parameters

POST 
/atm-testrun/find

Search for entities with the filters and arguments specified in 'DataReadParams' (see request schema), with optional mapping expansions via 'map'. Note that 'filter' should include a 'project_id' parameter if API key permissions are restricted to a single project.

Request

application/json

Body

required

computedColumns string[]

List of computed columns to include (by default includes all)

id integer

Only return the entity with the given id, returns one or none

ids integer[]

Only return the entities with the given ids

map

object

Map expression to expand properties or relationships with other entities

oneOf

MapJoin

entities

object

The list of entity names which are part of the mapping (for mapping relationship tables)

oneOf

MOD1

string

MOD2

Array [

string

]

entity string

The entity name (for direct mapping via a foreign key)

ids

object

A list of id tuples to filter by

oneOf

FkIdsNullable

Entity ids for mapped entities, e.g. testcase_id (also allows null as value)

property name*

object

oneOf

MOD1

integer

MOD2

string

MOD2

Array [

property name*

object

oneOf

MOD1

integer

MOD2

string

]

inverse boolean

Inverts the result to retrieve non-mapped entities

Default value: false

filter

object

Filter/search terms

and

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

or

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

property name*

object

oneOf

MOD1

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

MOD2

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

object

required

The target value(s) or pattern

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

col

MOD3

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

col stringrequired

The target column/prop name (instead of fixed value)

resultFilter

object

Filter/search terms

and

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

or

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

property name*

object

oneOf

MOD1

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

MOD2

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

object

required

The target value(s) or pattern

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

col

MOD3

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

col stringrequired

The target column/prop name (instead of fixed value)

countOnly boolean

Only returns a count instead of a list of entities

Default value: false

idOnly boolean

Only retrieves entity ids, omitting all other columns

Default value: false

optional boolean

Indicates that the mapping is optional and may be 'null' in the result

Default value: false

includeDeleted boolean

Includes deleted member entities in the mapping search result

Default value: false

omitLargeValues boolean

Omits 'large' column/prop values (if available)

Default value: false

omit boolean

Omit the mapping result from result entities - For intermediate nested mappings

result string

The entity to use as the result instead of the mapping relationship entity data

resultIncludeMapping boolean

Also includes mapping even if result entity is specified

Default value: false

map

object

Nested mapping starting from one of the member entities of this mapping

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

]

MOD2

Array [

entities

object

The list of entity names which are part of the mapping (for mapping relationship tables)

oneOf

MOD1

string

MOD2

Array [

string

]

entity string

The entity name (for direct mapping via a foreign key)

ids

object

A list of id tuples to filter by

oneOf

FkIdsNullable

Entity ids for mapped entities, e.g. testcase_id (also allows null as value)

property name*

object

oneOf

MOD1

integer

MOD2

string

MOD2

Array [

property name*

object

oneOf

MOD1

integer

MOD2

string

]

inverse boolean

Inverts the result to retrieve non-mapped entities

Default value: false

filter

object

Filter/search terms

and

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

or

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

property name*

object

oneOf

MOD1

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

MOD2

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

object

required

The target value(s) or pattern

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

col

MOD3

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

col stringrequired

The target column/prop name (instead of fixed value)

resultFilter

object

Filter/search terms

and

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

or

object

oneOf

ByKeys

Filter/search terms

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

MOD2

Array [

and

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

or

object

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

]

]

property name*

object

oneOf

MOD1

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

MOD2

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

object

required

The target value(s) or pattern

oneOf

ByKeysValue

Any basic JSON value (string, number, boolean, null)

oneOf

MOD1

string

MOD2

number

MOD3

boolean

MOD2

Array [

oneOf

MOD1

string

MOD2

number

MOD3

boolean

]

col

MOD3

op stringrequired

The comparison/matching operation to perform on the value: eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree

Possible values: [eq, not_eq, like, not_like, in, not_in, like_in, not_like_in, gt, lt, lte, gte, range, dtinterval, dinterval, dtintervalMillis, has_any, has_all, has_none, in_subtree]

value

col stringrequired

The target column/prop name (instead of fixed value)

countOnly boolean

Only returns a count instead of a list of entities

Default value: false

idOnly boolean

Only retrieves entity ids, omitting all other columns

Default value: false

optional boolean

Indicates that the mapping is optional and may be 'null' in the result

Default value: false

includeDeleted boolean

Includes deleted member entities in the mapping search result

Default value: false

omitLargeValues boolean

Omits 'large' column/prop values (if available)

Default value: false

omit boolean

Omit the mapping result from result entities - For intermediate nested mappings

result string

The entity to use as the result instead of the mapping relationship entity data

resultIncludeMapping boolean

Also includes mapping even if result entity is specified

Default value: false

map

object

Nested mapping starting from one of the member entities of this mapping

oneOf

MOD2

Array [

0

1

2

3

4

5

6

7

8

9

]

]

includeDeleted boolean

Includes soft-deleted entities in the result (if applicable)

omitLargeValues boolean
Omits 'large' column/prop values (if available)
Default value: true
omitForbidden boolean
Omits entities which are not allowed to be read rather than return an error
Default value: false
asOf string

Perform a history query given the asOf timestamp (if available)

idOnly boolean

Only returns ids in the result, omitting all other properties

countOnly boolean

Returns only the length of the result list instead of the result list itself

label string

Responses

200

Returns FindResult of type 'AutomationTestRun' expanded with specified mapped values

application/json

Schema

Schema

data

object[]

required

Array [

id integer

The unique entity id - must be a positive integer

title string

A descriptive title for this entity or mapping (1 to 200 characters)

Example: A Descriptive Title

project_id integer

The project id this entity or mapping belongs to

tags string

A list of tags for this entity

Example: important,release,smoketest

atm_source_id integer

The atm_source_id property

min_timestamp number

The min_timestamp property

max_timestamp number

The max_timestamp property

duration number

The duration property

status_highest number

The highest result status in this run, see the ordering of the result status values

is_completed boolean

The is_completed property

is_closed boolean

The is_closed property

closed_at date-time

The time this automation run was closed - all referenced automation test cases uses this as a historic timestamp

Example: 1970-01-01T00:00:00.000Z

closed_by number

The id of the user who closed this automation test run

Example: 0

is_pinned boolean

The is_pinned property

key_fields object

The key_fields property

key_fields_raw object

The key_fields_raw property

description stringnullable

An optional description for the test run (can be a rich text document)

Example:

stat_passed_count number

Number of passed results in this run

stat_passed_warn_count number

Number of passed with warning results in this run

stat_skipped_count number

Number of skipped results in this run

stat_blocked_count number

Number of blocked results in this run

stat_failed_count number

Number of failed results in this run

]

meta

object

required

count integerrequired

limit integer

offset integerrequired

totalCount integer

Example (from schema)

{
  "data": [
    {
      "id": 0,
      "title": "A Descriptive Title",
      "project_id": 0,
      "tags": "important,release,smoketest",
      "atm_source_id": 0,
      "min_timestamp": 0,
      "max_timestamp": 0,
      "duration": 0,
      "status_highest": 0,
      "is_completed": true,
      "is_closed": true,
      "closed_at": "1970-01-01T00:00:00.000Z",
      "closed_by": 0,
      "is_pinned": true,
      "key_fields": {},
      "key_fields_raw": {},
      "description": "",
      "stat_passed_count": 0,
      "stat_passed_warn_count": 0,
      "stat_skipped_count": 0,
      "stat_blocked_count": 0,
      "stat_failed_count": 0
    }
  ],
  "meta": {
    "count": 0,
    "limit": 0,
    "offset": 0,
    "totalCount": 0
  }
}

4XX

The request failed because invalid request parameters or data were supplied or access was denied.

application/json

Schema

Schema

code string
The error code describing the general error category.
Example: API_INVALID_INPUT_DATA
status integer

The HTTP status code.

message stringrequired

The actual error message describing the error in more detail.

reqid string

The request id for following up on specific errors.

Example (from schema)

{
  "code": "API_INVALID_INPUT_DATA",
  "status": 0,
  "message": "string",
  "reqid": "string"
}

5XX

The request failed because an error occurred during processing of the request.

application/json

Schema

Schema

code string
The error code describing the general error category.
Example: API_INVALID_INPUT_DATA
status integer

The HTTP status code.

message stringrequired

The actual error message describing the error in more detail.

reqid string

The request id for following up on specific errors.

Example (from schema)

{
  "code": "API_INVALID_INPUT_DATA",
  "status": 0,
  "message": "string",
  "reqid": "string"
}

Loading...