Select fields (fields)

You can specify the fields to be returned from the server in the response to a GET operation on a collection.

Using the fields clause is useful when GETting certain fields that are not listed by default, often for performance reasons. Some examples are: user-defined fields, comments, attachments, runs, and run steps.

The fields parameter

Select fields with the fields parameter. The fields parameter has the following syntax: 

fields=<field name>[[,<field name>]]

  • The field's ID and type are always returned regardless of the fields you select.

  • Field names are separated by commas: ,

  • If no fields parameter is provided, a default set of fields is returned.

Examples

See also: