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

POST 
/atm-source/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 'AutomationSource' expanded with specified mapped values

application/json

Schema

Schema

data

object[]

required

Array [

id integer

The unique entity id - must be a positive integer

project_id integer

The project id this entity or mapping belongs to

name string

The name property

display_name string

Display name for automation source in user interface

Example: Main integration tests

retention_days number

The retention_days property

]

meta

object

required

count integerrequired

limit integer

offset integerrequired

totalCount integer

Example (from schema)

{
  "data": [
    {
      "id": 0,
      "project_id": 0,
      "name": "string",
      "display_name": "Main integration tests",
      "retention_days": 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...