--- title: "Get all powerpacks" method: GET path: "/api/v2/powerpacks" tags: ["Powerpack"] --- # Get all powerpacks `GET /api/v2/powerpacks` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/powerpacks` - Auth: one of: - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` - OAuth 2 - Authorization code: `/oauth2/v1/authorize` - Token URL: `/oauth2/v1/token` scopes: `dashboards_read` Get a list of all powerpacks. ## Query parameters - `page[limit]` integer - `page[offset]` integer ## Response `200` OK - ListPowerpacksResponse: Response object which includes all powerpack configurations. - `data` PowerpackData[]: List of powerpack definitions. - `attributes` PowerpackAttributes: Powerpack attribute object. - `description` string: Description of this powerpack. - `group_widget` PowerpackGroupWidget, required: Powerpack group widget definition object. - `definition` PowerpackGroupWidgetDefinition, required: Powerpack group widget object. - `layout_type` string, required: Layout type of widgets. - `show_title` boolean: Boolean indicating whether powerpack group title should be visible or not. - `title` string: Name for the group widget. - `type` string, required: Type of widget, must be group. - `widgets` PowerpackInnerWidgets[], required: Widgets inside the powerpack. - `definition` object, required: Information about widget. - `layout` PowerpackInnerWidgetLayout: Powerpack inner widget layout. - … - `layout` PowerpackGroupWidgetLayout: Powerpack group widget layout. - `height` integer, required: The height of the widget. Should be a non-negative integer. - `width` integer, required: The width of the widget. Should be a non-negative integer. - `x` integer, required: The position of the widget on the x (horizontal) axis. Should be a non-negative integer. - `y` integer, required: The position of the widget on the y (vertical) axis. Should be a non-negative integer. - `live_span` '1m' | '5m' | '10m' | '15m' | '30m' | '1h' | '4h' | '1d' | '2d' | '1w' | '1mo' | '3mo' | '6mo' | '1y' | 'alert': The available timeframes depend on the widget you are using. - `name` string, required: Name of the powerpack. - `tags` string[]: List of tags to identify this powerpack. - `template_variables` PowerpackTemplateVariable[]: List of template variables for this powerpack. - `available_values` string[], nullable: The list of values that the template variable drop-down is limited to. - `defaults` string[]: One or many template variable default values within the saved view, which are unioned together using `OR` if more than one is specified. - `name` string, required: The name of the variable. - `prefix` string, nullable: The tag prefix associated with the variable. Only tags with this prefix appear in the variable drop-down. - `id` string: ID of the powerpack. - `relationships` PowerpackRelationships: Powerpack relationship object. - `author` RelationshipToUser: Relationship to user. - `data` RelationshipToUserData, required: Relationship to user object. - `id` string, required: A unique identifier that represents the user. - `type` 'users', required: Users resource type. - `type` string: Type of widget, must be powerpack. - `included` User[]: Array of objects related to the users. - `attributes` UserAttributes: Attributes of user object returned by the API. - `created_at` string, date-time: The ISO 8601 timestamp of when the user account was created. - `disabled` boolean: Whether the user account is deactivated. Disabled users cannot log in. - `email` string: The email address of the user, used for login and notifications. - `handle` string: The unique handle (username) of the user, typically matching their email prefix. - `icon` string: URL of the user's profile icon, typically a Gravatar URL derived from the email address. - `last_login_time` string, date-time, nullable: The ISO 8601 timestamp of the user's most recent login, or null if the user has never logged in. - `mfa_enabled` boolean: Whether multi-factor authentication (MFA) is enabled for the user's account. - `modified_at` string, date-time: The ISO 8601 timestamp of when the user account was last modified. - `name` string, nullable: The full display name of the user as shown in the Datadog UI. - `service_account` boolean: Whether this is a service account rather than a human user. Service accounts are used for programmatic API access. - `status` string: The current status of the user account (for example, `Active`, `Pending`, or `Disabled`). - `title` string, nullable: The job title of the user (for example, "Senior Engineer" or "Product Manager"). - `uuid` string: The globally unique identifier (UUID) of the user. - `verified` boolean: Whether the user's email address has been verified. - `id` string: ID of the user. - `relationships` UserResponseRelationships: Relationships of the user object returned by the API. - `org` RelationshipToOrganization: Relationship to an organization. - `data` RelationshipToOrganizationData, required: Relationship to organization object. - `id` string, required: ID of the organization. - `type` 'orgs', required: Organizations resource type. - `other_orgs` RelationshipToOrganizations: Relationship to organizations. - `data` RelationshipToOrganizationData[], required: Relationships to organization objects. - `id` string, required: ID of the organization. - `type` 'orgs', required: Organizations resource type. - `other_users` RelationshipToUsers: Relationship to users. - `data` RelationshipToUserData[], required: Relationships to user objects. - `id` string, required: A unique identifier that represents the user. - `type` 'users', required: Users resource type. - `roles` RelationshipToRoles: Relationship to roles. - `data` RelationshipToRoleData[]: An array containing type and the unique identifier of a role. - `id` string: The unique identifier of the role. - `type` 'roles': Roles type. - `type` 'users': Users resource type. - `links` PowerpackResponseLinks: Links attributes. - `first` string: Link to last page. - `last` string, nullable: Link to first page. - `next` string: Link for the next set of results. - `prev` string, nullable: Link for the previous set of results. - `self` string: Link to current page. - `meta` PowerpacksResponseMeta: Powerpack response metadata. - `pagination` PowerpacksResponseMetaPagination: Powerpack response pagination metadata. - `first_offset` integer: The first offset. - `last_offset` integer, nullable: The last offset. - `limit` integer: Pagination limit. - `next_offset` integer: The next offset. - `offset` integer: The offset. - `prev_offset` integer: The previous offset. - `total` integer: Total results. - `type` string: Offset type. ## Other responses - `429`: Too many requests --- [API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)