Team

An organization team. Teams group org members for shared configuration. Each org has exactly one system team named "General" which is created automatically and cannot be deleted. Every team carries four role-contact slots embedded as full contact resources: registrant_contact and admin_contact are required on live teams; tech_contact and billing_contact are optional and may be null. The member_preview field is a capped, embedded snapshot of the team's most-recently-active members so frontends can render avatar stacks without a second round-trip. Use /teams/{team_id}/members for the full paginated list.

  • object
    Type: string

    Resource type identifier, always "team"

  • billing_contact
    Type: Contact

    Embedded billing contact. Optional; null when unset.

    Properties: 25
  • member_preview
    Type: TeamMemberPreview

    Capped preview of the team's most-recently-active members, plus the team's full member count. Always present; empty for newly created teams or when preview enrichment fails.

    Properties: 3
  • created_at
    Type: string

    Creation timestamp in RFC 3339 UTC form

  • updated_at
    Type: string

    Last-update timestamp in RFC 3339 UTC form

  • id
    Type: string

    Stable identifier for the team

  • org_id
    Type: string

    Identifier of the owning organization

  • name
    Type: string

    Display name (e.g. "General", "London")

  • slug
    Type: string

    URL-safe slug, unique within the org

  • is_system
    Type: boolean

    True when this is the org's system team. Its slug is locked and the row cannot be deleted; name and other fields remain editable.

  • registrant_contact
    Type: Contact

    Embedded registrant contact. Required on live teams; clearing on update is rejected. Null only on pre-backfill rows.

    Properties: 25
  • admin_contact
    Type: Contact

    Embedded admin contact. Required on live teams; clearing on update is rejected. Null only on pre-backfill rows.

    Properties: 25
  • tech_contact
    Type: Contact

    Embedded technical contact. Optional; null when unset.

    Properties: 25