Get Current Iterations

Returns all currently started iterations for the authenticated user based on their team memberships. The 'current' iterations are determined by finding started iterations associated with teams the user belongs to. If multiple iterations match, all are returned sorted by start date (ascending), then end date (ascending), then ID (ascending).

get/api/v4/{workspace-slug}/iterations/current

Request

  • Base URL: https://api.app.shortcut.com
  • URL: https://api.app.shortcut.com/api/v4/{workspace-slug}/iterations/current
  • Auth: HTTP bearer

Path parameters

workspace-slugstring required

The slug for the Workspace.

Query parameters

limitinteger

The number of results to include in a page. Can be between 1 and 100. Defaults to 10.

cursorstring

The cursor indicating where we are in a paged response. If sent, it (and an optional fields parameter) must be the only parameters.

order_by'updated_at' | 'start_date'

Order the results by this property and direction.

order_dir'desc' | 'asc'

Order order_by in this direction. If order_by not provided, the default order property for this entity type will be used.

filter'all'

Filter options (default: :all).

fieldsstring

Fields to include in the response, as a comma-separated string. If provided, only these fields will be included for each entity in the response. If not present, all fields will be returned.

Response

Resource

$schemastring required

The URI for the json-schema for this response.

current_itemsinteger required

The number of items on the current page.

current_pageinteger required

The number of the current page.

total_itemsinteger required

The number of total items across all pages.

total_pagesinteger required

The total number of pages.

next_page_urlstring

A URL to get the next page. Will be absent on the last page.

Changes

No recorded changes to this operation across all 1 revision of this API.