feat(api): add SentryTeam type and listTeams API function

Adds the SentryTeam Zod schema, type export, and listTeams()
API client function needed by the team list command.

Author: betegon

plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -440,6 +440,33 @@ List repositories
 - `-n, --limit <value> - Maximum number of repositories to list - (default: "30")`
 - `--json - Output JSON`
 
+### Team
+
+Work with Sentry teams
+
+#### `sentry team list <org>`
+
+List teams
+
+**Flags:**
+- `-n, --limit <value> - Maximum number of teams to list - (default: "30")`
+- `--json - Output JSON`
+
+**Examples:**
+
+```bash
+# Auto-detect organization or list all
+sentry team list
+
+# List teams in a specific organization
+sentry team list <org-slug>
+
+# Limit results
+sentry team list --limit 10
+
+sentry team list --json
+```
+
 ### Log
 
 View Sentry logs
@@ -594,6 +621,18 @@ List repositories
 - `-n, --limit <value> - Maximum number of repositories to list - (default: "30")`
 - `--json - Output JSON`
 
+### Teams
+
+List teams
+
+#### `sentry teams <org>`
+
+List teams
+
+**Flags:**
+- `-n, --limit <value> - Maximum number of teams to list - (default: "30")`
+- `--json - Output JSON`
+
 ### Logs
 
 List logs from a project

src/lib/api-client.ts

@@ -27,6 +27,8 @@ import {
   SentryProjectSchema,
   type SentryRepository,
   SentryRepositorySchema,
+  type SentryTeam,
+  SentryTeamSchema,
   type SentryUser,
   SentryUserSchema,
   type TraceSpan,
@@ -602,6 +604,16 @@ export function listRepositories(orgSlug: string): Promise<SentryRepository[]> {
   );
 }
 
+/**
+ * List teams in an organization.
+ * Uses region-aware routing for multi-region support.
+ */
+export function listTeams(orgSlug: string): Promise<SentryTeam[]> {
+  return orgScopedRequest<SentryTeam[]>(`/organizations/${orgSlug}/teams/`, {
+    schema: z.array(SentryTeamSchema),
+  });
+}
+
 /**
  * Search for projects matching a slug across all accessible organizations.
  *

src/types/index.ts

@@ -74,6 +74,7 @@ export type {
   SentryOrganization,
   SentryProject,
   SentryRepository,
+  SentryTeam,
   SentryUser,
   Span,
   StackFrame,
@@ -114,6 +115,7 @@ export {
   SentryOrganizationSchema,
   SentryProjectSchema,
   SentryRepositorySchema,
+  SentryTeamSchema,
   SentryUserSchema,
   SpanSchema,
   StackFrameSchema,

src/types/sentry.ts

@@ -810,3 +810,22 @@ export const SentryRepositorySchema = z
   .passthrough();
 
 export type SentryRepository = z.infer<typeof SentryRepositorySchema>;
+
+// Team
+
+/** A team in a Sentry organization */
+export const SentryTeamSchema = z
+  .object({
+    // Core identifiers (required)
+    id: z.string(),
+    slug: z.string(),
+    name: z.string(),
+    // Optional metadata
+    dateCreated: z.string().optional(),
+    isMember: z.boolean().optional(),
+    teamRole: z.string().nullable().optional(),
+    memberCount: z.number().optional(),
+  })
+  .passthrough();
+
+export type SentryTeam = z.infer<typeof SentryTeamSchema>;