autessa.company
Company settings, team membership, roles, billing, and usage limits.
autessa.company.membersREAD
autessa.company.members()List the company's members and each member's effective permissions.
Returns every member of the company with their user record and the permissions they hold in this company. Read-only; any member may call it.
Request fields
No fields.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
members- Type
- Member[]
- Description
autessa.company.role.allREAD
autessa.company.role.all()List the roles available in the company: the six built-in roles plus any custom roles.
Returns the assignable roles with their permissions. The six built-in roles are Admin, Accountant, Developer, Manager, User, and Consultant; User is the base role granted on auto-join. Use these ids with company.user.invite. Read-only.
Request fields
No fields.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
roles- Type
- RoleDto[]
- Description
autessa.company.teams.createMUTATE
autessa.company.teams.create({ name, description })Create a team.
Requires the manage-team-members permission. Returns the new team (with a member count of 0). A duplicate or invalid name is rejected.
Request fields
- Name
name- Type
- string
- Description
- Name
description- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
team- Type
- TeamDto
- Description
autessa.company.teams.deleteMUTATE
autessa.company.teams.delete({ teamId })Delete a team.
Requires the manage-team-members permission. Removes the team and its memberships.
Request fields
- Name
teamId- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
autessa.company.teams.listREAD
autessa.company.teams.list()List the company's teams with their member counts.
Returns every team in the company. Read-only; any member may call it.
Request fields
No fields.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
teams- Type
- TeamDto[]
- Description
autessa.company.teams.members.addMUTATE
autessa.company.teams.members.add({ teamId, userId })Add a company member to a team.
Requires the manage-team-members permission. If the team governs AutessaDB table access, the caller must additionally hold ADMIN on those tables (so team management cannot be used to hand out table access). Returns the new team membership.
Request fields
- Name
teamId- Type
- string
- Description
- Name
userId- Type
- string (opaque id)
- Description
- References user by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
member- Type
- TeamMemberDto
- Description
autessa.company.teams.members.listREAD
autessa.company.teams.members.list({ teamId })List a team's members.
Returns the members of the given team. Read-only; any company member may call it.
Request fields
- Name
teamId- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
members- Type
- TeamMemberDto[]
- Description
autessa.company.teams.members.removeMUTATE
autessa.company.teams.members.remove({ teamId, userId })Remove a member from a team.
Requires the manage-team-members permission. Removes the user's membership in the team (does not remove them from the company).
Request fields
- Name
teamId- Type
- string
- Description
- Name
userId- Type
- string (opaque id)
- Description
- References user by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
autessa.company.teams.updateMUTATE
autessa.company.teams.update({ teamId, name, description })Rename a team or change its description.
Requires the manage-team-members permission. Pass only the fields to change — a null name or description leaves that field unchanged. Returns the updated team.
Request fields
- Name
teamId- Type
- string
- Description
- Name
name- Type
- string
- Description
- Name
description- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
team- Type
- TeamDto
- Description
autessa.company.updateMUTATE
autessa.company.update({ newCompanyName })Rename the company.
Requires the manage-team-members permission. Pass newCompanyName to rename the company. Ownership transfer is intentionally not available through the SDK — an undeclared field on this request is rejected at dispatch; transfer ownership from the company settings page instead. Returns the updated company.
Request fields
- Name
newCompanyName- Type
- string
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
company- Type
- CompanyDto
- Description
autessa.company.usageStatusREAD
autessa.company.usageStatus()Read the company's current usage against every limit dimension: entities, executions, LLM/vibecode credits, phone, storage, semantic search, browser, and AI-task metering.
Each block reports used / limit / remaining (or the metering equivalent) at the company's resolved limits — the account-tier defaults with the company's overrides merged in. The dimensions are fetched in parallel and a dimension that fails to compute is returned as null rather than failing the whole call. Read-only; any member may call it.
Request fields
No fields.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
- Name
entityUsage- Type
- EntityUsageStatus
- Description
- Name
executionUsage- Type
- ExecutionUsageStatus
- Description
- Name
llmCreditUsage- Type
- LlmCreditUsageStatus
- Description
- Name
phoneCallUsage- Type
- PhoneCallUsageStatus
- Description
- Name
storageUsage- Type
- StorageUsageStatus
- Description
- Name
semanticSearchUsage- Type
- SemanticSearchUsageStatus
- Description
- Name
browserUsage- Type
- BrowserUsageStatus
- Description
- Name
vibecodeUsage- Type
- VibecodeCreditStatus
- Description
- Name
aiTaskUsage- Type
- AiTaskUsageStatus
- Description
autessa.company.user.inviteMUTATE
autessa.company.user.invite({ email, roleIds })Invite someone to the company by email, granting them one or more roles; sends an invitation email.
Requires the manage-team-members permission. roleIds must reference roles from company.role.all (unknown ids are dropped; at least one valid role is required). Grant the base 'User' role rather than Admin. Fails if the company is at its member cap. Sends the invite email; the recipient completes it via company.user.processInvite / acceptInvite.
Request fields
- Name
email- Type
- string
- Description
- Name
roleIds- Type
- string (opaque id)[]
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
autessa.company.user.removeMUTATE
autessa.company.user.remove({ userId })Remove a member from the company.
Requires the manage-team-members permission. The company owner cannot be removed. A member may remove themselves only when this company is not their default scope. Irreversible.
Request fields
- Name
userId- Type
- string (opaque id)
- Description
- References user by opaque id.
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description
autessa.company.user.role.updateMUTATE
autessa.company.user.role.update({ userId, roleIds })Set the roles assigned to a company member.
Requires the manage-team-members permission. Replaces the member's role assignments with roleIds; ids that are not assignable company roles are ignored, and the call is rejected if none remain valid (at least one valid role is required — this does not clear roles). The company owner's roles cannot be changed, and you cannot change your own. Use company.role.all to list assignable role ids and company.members to find a member's userId.
Request fields
- Name
userId- Type
- string (opaque id)
- Description
- References user by opaque id.
- Name
roleIds- Type
- string (opaque id)[]
- Description
Response fields
- Name
errors- Type
- string[]
- Description
- Name
deprecationWarnings- Type
- string[]
- Description
- Name
sessionToken- Type
- string
- Description