Skip to main content
GET
Get metadata on a single Team

Authorizations

Authorization
string
header
required

A static Affinity API key, presented as a bearer token.

Path Parameters

teamId
integer<int64>
required

Team ID

Required range: 1 <= x <= 9007199254740991

Query Parameters

includes
enum<string>[]

Additional properties to include in the response.

Available options:
membersPreview,
accessibleListsPreview

Response

OK

A Team. Opt-in properties are controlled by the includes query parameter.

id
integer<int64>
required

The unique identifier for the team

Required range: 1 <= x <= 9007199254740991
Example:

42

name
string
required

The name of the team

Example:

"Investments"

createdAt
string<date-time>
required

Timestamp when the team was created

Example:

"2024-03-01T15:22:00Z"

updatedAt
string<date-time> | null
required

Timestamp when the team was last updated, or null if never updated

Example:

"2026-04-18T09:11:23Z"

privacyType
enum<string>

Visibility policy applied to interactions belonging to this team's members. share-subjects-bodies exposes all interactions; share-subjects exposes a selective subset; hide-subjects-bodies hides interaction content but exposes metadata; no-access exposes no interactions. Only returned when the caller has the "Manage Teams" permission, the organization has team-based privacy controls enabled, and cross-team visibility is enabled for the organization; omitted from the response otherwise.

Available options:
share-subjects-bodies,
share-subjects,
hide-subjects-bodies,
no-access
Example:

"hide-subjects-bodies"

membersPreview
TeamMembersPreview · object

Preview of the team's members. Only included when membersPreview is requested via the includes query parameter. totalCount is the total number of members on the team; full data is available via the paginated endpoint GET /v2/teams/{teamId}/members.

accessibleListsPreview
TeamAccessibleListsPreview · object

Preview of the Lists this team has access to. Only included when accessibleListsPreview is requested via the includes query parameter. totalCount is the total number of Lists this team can access; full data is available via the paginated endpoint GET /v2/teams/{teamId}/accessible-lists.