archastro.platform.types.teams

  1# Copyright (c) 2026 ArchAstro Inc. Licensed under the MIT License.
  2# This file is auto-generated by @archastro/sdk-generator. Do not edit.
  3# Content hash: 6ab488d596c8
  4
  5from datetime import datetime
  6from typing import Any
  7
  8from pydantic import BaseModel, Field
  9
 10from .common import Acl, Agent
 11from .image import ImageSource
 12from .users import User
 13
 14
 15class Team(BaseModel):
 16    """
 17    A team within an organization, used to group users and agents and scope resources like configs, agents, and tasks.
 18    """
 19
 20    acl: Acl | None = Field(
 21        default=None,
 22        description="Access control list governing visibility and join permissions for this team. `null` when no ACL restrictions are applied and the team inherits default access rules.",
 23    )
 24    app: str | None = Field(
 25        default=None,
 26        description="ID of the developer application this team belongs to (`dap_...`). `null` if the team is not scoped to an app.",
 27    )
 28    badges: dict[str, Any] | None = Field(
 29        default=None,
 30        description="Aggregated badge counts for the team, keyed by category. `null` when badge data is not loaded.",
 31    )
 32    created_at: datetime | None = Field(
 33        default=None, description="When this team was created (ISO 8601)."
 34    )
 35    description: str | None = Field(
 36        default=None,
 37        description="Human-readable description of the team's purpose. `null` if not set.",
 38    )
 39    id: str = Field(..., description="Team ID (`tem_...`).")
 40    membership_status: str | None = Field(
 41        default=None,
 42        description='The authenticated viewer\'s role on this team. One of `"owner"`, `"admin"`, or `"member"`. `null` if the viewer is not a member.',
 43    )
 44    metadata: dict[str, Any] | None = Field(
 45        default=None,
 46        description="Arbitrary key-value metadata attached to this team. Returns an empty object when no metadata has been set.",
 47    )
 48    name: str | None = Field(default=None, description="Display name of the team.")
 49    org: str | None = Field(
 50        default=None,
 51        description="ID of the organization this team belongs to (`org_...`). `null` if the team is not org-scoped.",
 52    )
 53    sandbox: str | None = Field(
 54        default=None,
 55        description="ID of the developer sandbox this team is scoped to (`dsb_...`). `null` outside sandbox contexts.",
 56    )
 57    slug: str | None = Field(
 58        default=None,
 59        description="URL-safe slug for the team, derived from the team name. `null` if not set.",
 60    )
 61    updated_at: datetime | None = Field(
 62        default=None, description="When this team was last updated (ISO 8601)."
 63    )
 64
 65
 66class TeamDeleteImpactResponse(BaseModel):
 67    """
 68    The stored custom-object rows that a Team deletion will physically remove.
 69    """
 70
 71    custom_object_count: int = Field(
 72        ..., description="All custom-object rows owned by the Team, including soft-deleted rows."
 73    )
 74    custom_objects_physically_deleted: bool = Field(
 75        ...,
 76        description="Whether Team deletion physically deletes these rows; no restore is provided.",
 77    )
 78
 79
 80class TeamInvite(BaseModel):
 81    """
 82    A team invite containing a short alphanumeric code that other users can present to join the team.
 83    """
 84
 85    code: str = Field(
 86        ...,
 87        description="Short alphanumeric join code. Pass this value as `join_code` to the join-with-code endpoint to add a user to the team.",
 88    )
 89
 90
 91class TeamMembership(BaseModel):
 92    """
 93    A record representing a user's or agent's membership in a team, including their resolved identity details and role.
 94    """
 95
 96    agent: Agent | None = Field(
 97        default=None,
 98        description="The agent associated with this membership, as an expanded agent object. `null` when the member is a user, the type is unknown, or the association is not preloaded.",
 99    )
100    created_at: datetime | None = Field(
101        default=None, description="When this membership record was created (ISO 8601)."
102    )
103    id: str = Field(..., description="Team membership ID (`tmb_...`).")
104    joined_at: datetime | None = Field(
105        default=None, description="When the principal joined the team (ISO 8601)."
106    )
107    metadata: dict[str, Any] | None = Field(
108        default=None,
109        description="Arbitrary key-value metadata attached to this membership record. `null` if no metadata has been set.",
110    )
111    name: str | None = Field(
112        default=None,
113        description="Display name of the member, derived from the associated user or agent. `null` if the principal is unknown.",
114    )
115    profile_picture: ImageSource | None = Field(
116        default=None,
117        description="Profile picture of the member, derived from the associated user or agent. `null` if not set or principal is unknown.",
118    )
119    role: str | None = Field(
120        default=None,
121        description='The member\'s role within the team. One of `"owner"`, `"admin"`, or `"member"`.',
122    )
123    team: dict[str, Any] | None = Field(
124        default=None,
125        description="The team this membership belongs to, as an expanded team object. `null` when the team association is not preloaded.",
126    )
127    type: str | None = Field(
128        default=None,
129        description='Resolved principal type. One of `"user"`, `"agent"`, or `"unknown"` when the principal cannot be determined.',
130    )
131    updated_at: datetime | None = Field(
132        default=None, description="When this membership record was last updated (ISO 8601)."
133    )
134    user: User | None = Field(
135        default=None,
136        description="The user associated with this membership, as an expanded user object. `null` when the member is an agent, the type is unknown, or the association is not preloaded.",
137    )
138
139
140class TeamMembershipListResponse(BaseModel):
141    """
142    A paginated list of team memberships returned by the list team memberships endpoint.
143    """
144
145    data: list[TeamMembership] = Field(
146        ..., description="Array of team membership objects for the current page."
147    )
148    has_next: bool | None = Field(
149        default=None,
150        description="`true` if a subsequent page exists; `false` when this is the last page.",
151    )
152    has_prev: bool | None = Field(
153        default=None,
154        description="`true` if a previous page exists; `false` when this is the first page.",
155    )
156    page: int | None = Field(default=None, description="Current page number, starting at `1`.")
157    page_size: int | None = Field(
158        default=None, description="Maximum number of results returned per page."
159    )
160    total_entries: int | None = Field(
161        default=None,
162        description="Total number of team memberships matching the applied filters across all pages.",
163    )
164    total_pages: int | None = Field(
165        default=None, description="Total number of pages given the current `page_size`."
166    )