Get time periods
The Asana Get Time Periods tool allows users to retrieve and filter available time periods within an Asana workspace. Ideal for goal planning, reporting, and managing OKR cycles, it provides detailed information such as period names, IDs, and their start and end dates.
Features
- Retrieve time periods available in a specific Asana workspace.
- Filter time periods by custom date ranges using ISO 8601 formatted dates.
- Supports pagination with limit and offset parameters to manage large data sets.
- Returns detailed information including time period names, IDs, start dates, and end dates.
- Facilitates integration with goal planning, reporting periods, and OKR cycle management workflows.
Benefits
- Streamlines goal planning by providing precise time period data.
- Enhances reporting accuracy with customizable date filtering.
- Improves OKR cycle management through easy access to relevant time periods.
- Reduces manual effort in tracking timelines by automating data retrieval.
- Supports scalable data handling with pagination controls for large workspaces.
Description
List available time periods in a workspace. Filterable by date range. Returns time period names, IDs, start/end dates. REQUIRES workspace parameter. Use for goal planning, reporting periods, or OKR cycles.
Parameters
6 parameters
| Name | Type | Description |
|---|---|---|
| workspacerequired | string | Globally unique identifier for the workspace. Required. |
| start_on | string | ISO 8601 date string for filtering periods starting on or after this date. |
| end_on | string | ISO 8601 date string for filtering periods ending on or before this date. |
| opt_fields | string | Comma-separated list of optional fields to include in the response. |
| limit | number | Number of time periods to return per page (1-100). |
| offset | string | Pagination offset token. |
