Bigin icon

Bigin

Consume Bigin API

Task → Get

AI-generated

Summary

Retrieve one or multiple specific Tasks from Bigin by specifying their IDs, URLs, or searching via a filtered list. Optionally select all fields or choose specific fields (up to 50) to include in the returned data.

Inputs

  • Recordid (required) — Select the Task(s) to retrieve by providing either an ID, URL, or a searchable list of Task records.
  • Selectallfields — Boolean toggle to select all available fields for each Task; defaults to true.
  • Selectfields — If 'Select All Fields' is unchecked, specify which fields to return (e.g., Name, Owner, Created_Time). Up to 50 fields allowed.
  • Recordlist — When retrieving many Tasks, optionally provide a JSON array of Task records from which to extract IDs to fetch.

Output shape

a single Task record or an array of Task records, each including the selected fields

When inputting multiple Tasks via 'Recordlist' or the 'List' mode of 'Recordid', returns an array of Task objects. If retrieving a single Task by ID or URL, returns a single Task object. Field selection caps at 50 fields per Bigin API limits; additional fields beyond that are skipped.

Examples

Example 1: Fetch one Task by ID and return all its fields.

Set 'Recordid' mode to 'ID' with the Task ID; leave 'Selectallfields' enabled.

Example 2: Fetch multiple Tasks by providing a JSON list of their IDs and return only specified fields.

Set 'Recordid' mode to 'List', input the JSON array string into 'Recordlist', and set 'Selectallfields' to false; then select desired fields in 'Selectfields'.

Links

Discussion