Skip to Content
Skip to Content
Organizations and usage

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 capabilities

org 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 member

An 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 members

Roles 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 --force

Organization 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-top

The 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 20

Replace 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 list

Choose 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 2

Replace 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.

Last updated on