List teams
The List Teams tool by Linear provides a seamless way to retrieve and manage teams within your Linear workspace. It enables users to fetch detailed team information with customizable filters and sorting.
Features
- Retrieve a list of teams in your Linear workspace with flexible limits (up to 250).
- Filter teams based on creation or update date using ISO-8601 date-time or duration formats.
- Search teams using customizable query strings for precise results.
- Include or exclude archived teams dynamically during queries.
- Sort results by creation or update timestamps to prioritize recent activity.
Benefits
- Enhances team management efficiency by providing quick access to team data.
- Allows precise filtering and searching to find relevant teams effortlessly.
- Supports scalability with adjustable limits for handling large workspaces.
- Improves project tracking by focusing on active or archived teams as needed.
- Simplifies workflow automation with reliable and idempotent API calls.
Description
List teams in the user's Linear workspace
Parameters
8 parameters
| Name | Type | Description |
|---|---|---|
| limit | number | The number of results to return (Max is 250) |
| before | string | An ID to end at |
| after | string | An ID to start from |
| orderBy | enum | The order in which to return results |
| query | string | An optional search query |
| includeArchived | boolean | Whether to include archived teams |
| createdAt | string | Return only teams created on or after this ISO-8601 date-time or duration. e.g. -P1D to get teams created in the last day |
| updatedAt | string | Return only teams updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get teams updated in the last day |