Datadog/teams

@webframp/datadog/teamsv2026.10.21.1· Apache-2.0· 5d agoBEHAVIORS

01README

Datadog Teams — team management, memberships, and permissions

02Release Notes

2026.10.21.1

Changed: The README now shows how to store the API key and application key in a datadog vault and wire them with ${{ vault.get("datadog", "API_KEY") }} and ${{ vault.get("datadog", "APP_KEY") }}. The previous example passed DD_API_KEY and DD_APP_KEY as literal global arguments, which swamp rejects for sensitive arguments.

Changed: The apiKey and appKey descriptions now say to supply them with a vault.get expression. Both were already marked sensitive.

Upgrade note: Documentation and argument descriptions only. Methods, arguments, resource schemas and stored data are unchanged.

03Behaviors1

@webframp/datadog/teamsv2026.10.21.1datadog/teams.ts

Global Arguments

Argument	Type	Required	Description
apiKey	string	yes	Datadog API key (DD-API-KEY). Wire it with ${{ vault.get("datadog", "API_KEY") }}; never pass the literal value.
appKey	string	yes	Datadog application key (DD-APPLICATION-KEY). Wire it with ${{ vault.get("datadog", "APP_KEY") }}; never pass the literal value.
site?	enum	no	Datadog site

fn list_teams(sort?: string, include?: string, filter_keyword?: string, filter_me?: boolean, fields_team?: string)

Get all teams

Argument	Type	Required	Description
sort?	string	no	Specifies the order of the returned teams
include?	string	no	Included related resources optionally requested. Allowed enum values: `team_l...
filter_keyword?	string	no	Search query. Can be team name, team handle, or email of team member
filter_me?	boolean	no	When true, only returns teams the current user belongs to
fields_team?	string	no	List of fields that need to be fetched.

fn create_team(avatar?: string, banner?: number, description?: string, handle: string, hidden_modules?: array, name: string, visible_modules?: array)

Create a team

Argument	Type	Required	Description
avatar?	string	no	Unicode representation of the avatar for the team, limited to a single grapheme
banner?	number	no	Banner selection for the team
description?	string	no	Free-form markdown description/content for the team's homepage
handle	string	yes	The team's identifier
hidden_modules?	array	no	Collection of hidden modules for the team
name	string	yes	The name of the team
visible_modules?	array	no	Collection of visible modules for the team

fn list_team_hierarchy_links(filter_parent_team?: string, filter_sub_team?: string)

Get team hierarchy links

Argument	Type	Required	Description
filter_parent_team?	string	no	Filter by parent team ID
filter_sub_team?	string	no	Filter by sub team ID

fn add_team_hierarchy_link(relationships: unknown, type: unknown)

Create a team hierarchy link

Argument	Type	Required	Description
relationships	unknown	yes
type	unknown	yes

fn get_team_hierarchy_link(link_id: string)

Get a team hierarchy link

Argument	Type	Required	Description
link_id	string	yes	The team hierarchy link's identifier

fn remove_team_hierarchy_link(link_id: string)

Remove a team hierarchy link

Argument	Type	Required	Description
link_id	string	yes	The team hierarchy link's identifier

fn list_team_connections(filter_sources?: string, filter_team_ids?: string, filter_connected_team_ids?: string, filter_connection_ids?: string)

List team connections

Argument	Type	Required	Description
filter_sources?	string	no	Filter team connections by external source systems.
filter_team_ids?	string	no	Filter team connections by Datadog team IDs.
filter_connected_team_ids?	string	no	Filter team connections by connected team IDs from external systems.
filter_connection_ids?	string	no	Filter team connections by connection IDs.

fn create_team_connections(entries: array)

Create team connections

Argument	Type	Required	Description
entries	array	yes	Array of items to submit

fn delete_team_connections(entries: array)

Delete team connections

Argument	Type	Required	Description
entries	array	yes	Array of items to submit

fn get_team_sync(filter_source?: string)

Get team sync configurations

Argument	Type	Required	Description
filter_source?	string	no	Filter by the external source platform for team synchronization

fn sync_teams(frequency?: unknown, selection_state?: unknown, source: unknown, sync_membership?: unknown, type: unknown)

Link Teams with GitHub Teams

Argument	Type	Required
frequency?	unknown	no
selection_state?	unknown	no
source	unknown	yes
sync_membership?	unknown	no
type	unknown	yes

fn get_team(team_id: string)

Get a team

Argument	Type	Required	Description
team_id	string	yes	None

fn update_team(team_id: string, avatar?: string, banner?: number, description?: string, handle: string, hidden_modules?: array, name: string, visible_modules?: array)

Update a team

Argument	Type	Required	Description
team_id	string	yes	None
avatar?	string	no	Unicode representation of the avatar for the team, limited to a single grapheme
banner?	number	no	Banner selection for the team
description?	string	no	Free-form markdown description/content for the team's homepage
handle	string	yes	The team's identifier
hidden_modules?	array	no	Collection of hidden modules for the team
name	string	yes	The name of the team
visible_modules?	array	no	Collection of visible modules for the team

fn delete_team(team_id: string)

Remove a team

Argument	Type	Required	Description
team_id	string	yes	None

fn get_team_links(team_id: string)

Get links for a team

Argument	Type	Required	Description
team_id	string	yes	None

fn create_team_link(team_id: string, label: string, position?: number, url: string)

Create a team link

Argument	Type	Required	Description
team_id	string	yes	None
label	string	yes	The link's label
position?	number	no	The link's position, used to sort links for the team
url	string	yes	The URL for the link

fn get_team_link(team_id: string, link_id: string)

Get a team link

Argument	Type	Required	Description
team_id	string	yes	None
link_id	string	yes	None

fn update_team_link(team_id: string, link_id: string, label: string, position?: number, url: string)

Update a team link

Argument	Type	Required	Description
team_id	string	yes	None
link_id	string	yes	None
label	string	yes	The link's label
position?	number	no	The link's position, used to sort links for the team
url	string	yes	The URL for the link

fn delete_team_link(team_id: string, link_id: string)

Remove a team link

Argument	Type	Required	Description
team_id	string	yes	None
link_id	string	yes	None

fn get_team_memberships(team_id: string, sort?: string, filter_keyword?: string)

Get team memberships

Argument	Type	Required	Description
team_id	string	yes	None
sort?	string	no	Specifies the order of returned team memberships
filter_keyword?	string	no	Search query, can be user email or name

fn create_team_membership(team_id: string, provisioned_by?: string, provisioned_by_id?: string, role?: unknown)

Add a user to a team

Argument	Type	Required	Description
team_id	string	yes	None
provisioned_by?	string	no	The mechanism responsible for provisioning the team relationship. Possible va...
provisioned_by_id?	string	no	UUID of the User or Service Account who provisioned this team membership, or ...
role?	unknown	no

fn update_team_membership(team_id: string, user_id: string, provisioned_by?: string, provisioned_by_id?: string, role?: unknown)

Update a user's membership attributes on a team

Argument	Type	Required	Description
team_id	string	yes	None
user_id	string	yes	None
provisioned_by?	string	no	The mechanism responsible for provisioning the team relationship. Possible va...
provisioned_by_id?	string	no	UUID of the User or Service Account who provisioned this team membership, or ...
role?	unknown	no

fn delete_team_membership(team_id: string, user_id: string)

Remove a user from a team

Argument	Type	Required	Description
team_id	string	yes	None
user_id	string	yes	None

fn get_team_notification_rules(team_id: string)

Get team notification rules

Argument	Type	Required	Description
team_id	string	yes	None

fn create_team_notification_rule(team_id: string, email?: unknown, ms_teams?: unknown, pagerduty?: unknown, servicenow?: unknown, slack?: unknown)

Create team notification rule

Argument	Type	Required	Description
team_id	string	yes	None
email?	unknown	no
ms_teams?	unknown	no
pagerduty?	unknown	no
servicenow?	unknown	no
slack?	unknown	no

fn get_team_notification_rule(team_id: string, rule_id: string)

Get team notification rule

Argument	Type	Required	Description
team_id	string	yes	None
rule_id	string	yes	None

fn update_team_notification_rule(team_id: string, rule_id: string, email?: unknown, ms_teams?: unknown, pagerduty?: unknown, servicenow?: unknown, slack?: unknown)

Update team notification rule

Argument	Type	Required	Description
team_id	string	yes	None
rule_id	string	yes	None
email?	unknown	no
ms_teams?	unknown	no
pagerduty?	unknown	no
servicenow?	unknown	no
slack?	unknown	no

fn delete_team_notification_rule(team_id: string, rule_id: string)

Delete team notification rule

Argument	Type	Required	Description
team_id	string	yes	None
rule_id	string	yes	None

fn get_team_permission_settings(team_id: string)

Get permission settings for a team

Argument	Type	Required	Description
team_id	string	yes	None

fn update_team_permission_setting(team_id: string, action: string, value?: unknown)

Update permission setting for team

Argument	Type	Required	Description
team_id	string	yes	None
action	string	yes	None
value?	unknown	no

fn get_user_memberships(user_uuid: string)

Get user memberships

Argument	Type	Required	Description
user_uuid	string	yes	None

Resources

teams(infinite)— Get all teams

team(infinite)— Create a team

team_hierarchy_links(infinite)— Get team hierarchy links

add_team_hierarchy_link(infinite)— Create a team hierarchy link

team_hierarchy_link(infinite)— Get a team hierarchy link

team_connections(infinite)— List team connections

create_team_connections(infinite)— Create team connections

team_sync(infinite)— Get team sync configurations

sync_teams(infinite)— Link Teams with GitHub Teams

team_links(infinite)— Get links for a team

team_link(infinite)— Create a team link

team_memberships(infinite)— Get team memberships

team_membership(infinite)— Add a user to a team

team_notification_rules(infinite)— Get team notification rules

team_notification_rule(infinite)— Create team notification rule

team_permission_settings(infinite)— Get permission settings for a team

team_permission_setting(infinite)— Update permission setting for team

user_memberships(infinite)— Get user memberships

04Previous Versions14

2026.10.15.1Apache-2.0Oct 15, 2026

2026.10.15.1

Changed: Generated tests now include one execution test per method, so every method is covered. Nothing behavioral changed in the model code, schemas or resources.

2026.10.14.2Apache-2.0Oct 15, 2026

2026.10.14.2

Fixed: create_team_connections and delete_team_connections now send the entries array as the data payload. create_team_connections previously ran as a paginated POST search and could re-send the request; delete_team_connections sent no body and so could not delete anything.

Changed: create_team_connections is now a create method. It stores the raw API response ({data: [...]}) in the create_team_connections resource instead of the list-shaped {items, truncated} result, and its arguments changed from none to a required entries array.

Upgrade note: The resource schema accepts both shapes, so previously stored data still validates and no migration is needed.

2026.10.14.1Apache-2.0(was none)Oct 14, 2026

2026.10.14.1

Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.

Upgrade note: Metadata only. No code, schema, or behavioral changes.

2026.10.07.1

Added: Team notification rules accept a servicenow notification target (with templates) on create_team_notification_rule and update_team_notification_rule, and the stored rule schema includes it. Email notification settings gain an optional recipient_email field.

Fixed: The shared API helper no longer throws on a successful response with an empty body (such as 202 Accepted); it returns an empty result. Paginated list requests tolerate an empty page body the same way. A body that is not valid JSON now fails with an error naming the HTTP method, path, and status, with a snippet of the body.

Upgrade note: Additive changes only; existing stored resources remain valid and no migration is needed.

2026.09.18.1Sep 20, 2026

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.15.1Sep 15, 2026

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.09.08.1

Added: Initial code-generated release of @webframp/datadog/teams with 31 methods covering the Datadog teams API surface.

2026.09.08.1Sep 9, 2026

2026.09.08.1

Added: Initial code-generated release of @webframp/datadog/teams with 31 methods covering the Datadog teams API surface.

2026.08.28.2Aug 28, 2026

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; string schema patterns emit regex validation; output schemas passthrough unknown fields.

updated labels

2026.08.28.1Aug 28, 2026

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2Aug 27, 2026

2026.08.26.2

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.25.1Aug 26, 2026

2026.08.25.1

Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.

updated labels

2026.08.24.1Aug 24, 2026

2026.08.24.1

Added: Output metadata attributes for observability.

durationMs: Method execution duration in milliseconds.
collectedBy: Extension name that produced the data.
fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).

2026.08.21.2Aug 22, 2026

2026.08.21.2

Changed: Error messages and input validation are more specific.

API errors now name the HTTP method and path that was attempted (e.g. Datadog API HTTP 404: GET /api/v2/team-hierarchy-links/abc-123) instead of just the raw status code and response body.
A network-level failure (DNS error, connection reset, timeout) reaching the Datadog API now raises Datadog API request failed: <METHOD> <path>: <reason> instead of an unlabeled fetch error.
link_id is now rejected up front if empty on get_team_hierarchy_link and remove_team_hierarchy_link, instead of building a malformed request path.

No changes to request/response shapes or existing successful-path behavior.

2026.08.21.1

Changed: Tightened and clarified Zod schemas as part of a repo-wide schema audit.

Added .min(1) to apiKey and appKey in the global arguments schema — both are sent directly as request headers, and an empty value would never be accepted by the Datadog API.
Replaced the placeholder "None" description (a code-generation artifact) on 29 path-parameter arguments (team_id, link_id, user_id, rule_id, action, user_uuid) with real descriptions, and added .min(1) to each — every one of them is encodeURIComponent-ed directly into a request URL, so an empty value would always produce a malformed path.
Added descriptions to previously undocumented relationships, type, frequency, selection_state, source, sync_membership, role, email, ms_teams, pagerduty, slack, and value arguments.

No behavioral changes — these are documentation and validation tightenings only.

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/teams with 31 methods covering the Datadog teams API surface.

2026.08.21.1Aug 21, 2026

2026.08.21.1

Changed: Tightened and clarified Zod schemas as part of a repo-wide schema audit.

Added .min(1) to apiKey and appKey in the global arguments schema — both are sent directly as request headers, and an empty value would never be accepted by the Datadog API.
Replaced the placeholder "None" description (a code-generation artifact) on 29 path-parameter arguments (team_id, link_id, user_id, rule_id, action, user_uuid) with real descriptions, and added .min(1) to each — every one of them is encodeURIComponent-ed directly into a request URL, so an empty value would always produce a malformed path.
Added descriptions to previously undocumented relationships, type, frequency, selection_state, source, sync_membership, role, email, ms_teams, pagerduty, slack, and value arguments.

No behavioral changes — these are documentation and validation tightenings only.

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/teams with 31 methods covering the Datadog teams API surface.

2026.07.20.11Jul 20, 2026

2026.07.20.11

Added: Initial code-generated release of @webframp/datadog/teams with 31 methods covering the Datadog teams API surface.

05Stats

100 / 100

Downloads

Archive size

23.7 KB

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types (deprecated)1/1earned
Dependencies pass trust audit2/2earned
Has description1/1earned
Platform support declared (or universal)2/2earned
License2/2earned
Verified public repository2/2earned

Repository

https://github.com/webframp/swamp-extensions

06Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

07Labels

#datadog #teams #organization #rbac