PIpioneer
teams

Create Team

Changed on

Create a team.

Creating a workspace spends nothing. A new team opens at a zero balance, and inference on it is gated later. The caller's current wallet must not block the create.

Args: request: Team creation payload. auth: Authenticated caller. service: Team service.

Returns: Created team.

post/v1/teams

Request

Request body

namestring required

Name for the team

usage_reset_timezonestring nullable

IANA timezone for the daily credit reset hour. Defaults to UTC when omitted.

Response

Successful Response

idstring required
namestring required
owner_idstring required
zero_data_retentionboolean
created_atstring required
updated_atstring required
member_countinteger nullable
current_user_role'owner' | 'billing' | 'admin' | 'editor' | 'viewer'

Team member roles with hierarchical permissions.

Wire DTO mirror of the ORM TeamRoleType enum. Used only for API request/response serialization; authorization decisions route through the ORM matrix (database_tables.permissions), never this enum.

capabilitiesobject nullable
max_seatsinteger nullable

Cap on members plus pending invitations. Null means unlimited; a new team opens at the column's fail-closed default of 150 seats.

max_api_keysinteger nullable

Cap on active user-facing API keys, excluding internal run keys. Null means no team-specific cap, so the platform default applies; 0 forbids API keys.

Changes