Organizations

An organization owns its phones, sessions, workflows, runs, files, API keys, usage, and billing. An API key selects one organization for Python SDK, Go SDK, and REST API requests. OAuth CLI sessions can switch among the organizations your user belongs to.

Select an organization

Dashboard
CLI

Use the organization switcher in the dashboard sidebar. Dashboard URLs include the selected organization’s slug.Open Settings → General to inspect the selected organization.

axilio orgs list
axilio orgs use example-org

# Override the selection for one command.
axilio --org another-org workflows list

Organization switching requires an OAuth login. API-key logins stay bound to the key’s organization.

The Python SDK, Go SDK, and REST API do not provide a runtime organization selector when you authenticate with an API key. The credential determines the organization. To access another organization, use a key issued by that organization and create another SDK client or change the REST credential.

X-Axilio-Org selects an organization only for CLI OAuth requests. It is ignored when you authenticate with an API key, even if an SDK lets you add custom request headers.

Read the organization descriptor

Available fields differ by interface. The SDKs and REST API return the full public organization descriptor.

Dashboard
CLI
Python SDK
Go SDK
REST API

Open Settings → General after selecting the organization.The admin-only page shows the organization’s name, slug, ID, creation date, and additional account information. It is a dashboard summary, not the exact public API descriptor. For example, it does not show plan_name.

axilio orgs list

This OAuth-only command returns each accessible organization’s ID, slug, and name. It is a partial summary, not the full public descriptor. It does not return plan_name or created_at.

organization = client.raw.organization.get()

print(organization.id, organization.slug, organization.name)
print(organization.plan_name)

organization, err := api.Organization.Get(ctx)
if err != nil {
    log.Fatal(err)
}
fmt.Println(organization.ID, organization.Slug, organization.Name)

REST API References:

Get the caller’s organization: GET /organization

Examples use Bash. To run them in PowerShell, see Run the curl examples on Windows.

curl --silent --show-error --fail-with-body \
  --url https://api.axilio.ai/api/v1/organization \
  --header "X-Axilio-Api-Key: $AXILIO_API_KEY"

Renaming an organization and changing its members or invitations are dashboard-only actions. The public API can read member and invitation summaries but cannot mutate them.

Next steps

Members

Manage members in the dashboard or read summaries through the API.

API keys

Create, list, replace, and delete organization credentials.

Billing

Read the organization’s usage, balance, invoices, and dedicated rentals.

Get Started

Phones and Sessions

Workflows and Runs

Files

Observability

Telemetry

Usage

Billing

Organization

Reference

Select an organization

Read the organization descriptor

Next steps

Members

API keys

Billing

​Select an organization

​Read the organization descriptor

​Next steps

Members

API keys

Billing

Select an organization

Read the organization descriptor

Next steps