Organizations and usage
View organization information and manage members, usage queries, and audit logs. Check the permissions required for each task.
Check organizations
aipctl org list
aipctl org list --json
aipctl org current
aipctl org settings
aipctl org capabilitiesorg settings retrieves the signed-in user’s settings. It does not change organization settings. org capabilities lists features available in the selected organization. Use org use ORG_SLUG to switch organizations. A listed feature may still require separate access to the actual resources.
Manage members
Listing organization members requires AI Operator permissions. Invitations, role changes, and member removal require organization management permissions that allow the specific task.
aipctl org members
aipctl admin org invite colleague@example.com --role memberAn invitation command accepts up to 100 email addresses. If some invitations fail, check the affected addresses and reasons.
Before changing a member’s role or removing them, check their email and current status in the list.
aipctl admin org update-member-role colleague@example.com --role aiOperator
aipctl admin org remove-member colleague@example.com --force
aipctl org membersRoles are owner, admin, aiOperator, or member. Changes remain subject to your account permissions and organization policy. Role changes affect access; removal ends organization membership. If an error occurs, retrieve the latest list before continuing.
Leaving an organization affects membership and access, so check the target organization first.
aipctl org current
aipctl org exit --forceOrganization usage and audit logs
Organization administrators can check usage statistics.
aipctl admin usage credit
aipctl admin usage top-users
aipctl admin usage daily-graph
aipctl admin usage daily-users
aipctl admin usage mcp-topThe default period runs from the first day of this month through today. Set --start and --end in YYYY-MM-DD format to choose a period.
aipctl admin usage credit --start 2026-11-01 --end 2026-11-13
aipctl admin usage top-users --start 2026-11-01 --end 2026-11-13 --limit 20
aipctl admin usage daily-graph --start 2026-11-01 --end 2026-11-13
aipctl admin usage daily-users --start 2026-11-01 --end 2026-11-13 --page 2 --user-id USER_ID
aipctl admin usage mcp-top --start 2026-11-01 --end 2026-11-13 --limit 20Replace the dates with the period you need. top-users and mcp-top show the top 10 by default; change the count with --limit. For daily-users, use --page to select a page and --user-id to filter by user. Get user IDs from member information you are permitted to access. credit reports usage during the period, not the remaining credit balance.
Audit log access depends on the organization plan and your audit log permissions.
aipctl admin audit types
aipctl admin audit listChoose an event type from types to filter results or retrieve subsequent pages.
aipctl admin audit list --type EVENT_TYPE --page 1
aipctl admin audit list --type EVENT_TYPE --page 2Replace EVENT_TYPE with an identifier returned by types. Audit logs can contain user activity, so handle queried and saved results according to your organization’s rules.