Create API key

Creating an API key

In Studio

1. Open your project, go to Integrations, then the Credentials panel.
2. Under API Keys, enter a name and create the key.
3. The full key is shown once, in a confirmation dialog — copy it now, it won't be shown again.

Every project includes a Default API Key used by the project itself — it's what you'll see there by default. This key can't be revoked. Keys you create separately can be revoked independently. In CLI output, the Default API Key appears as client-api.

Via the CLI

machina credentials generate --name my-integration --org <org_id> --project <project_id>

• --org / --project default to whatever's set as your CLI defaults if omitted.
• --level defaults to SERVICE_ACCESS.
• The key is printed once — save it securely.

Obtaining your project's credentials

• Access Machina Studio → your project → Integrations → Credentials.
• There are two credentials available for integration: API address and API key.
• An API key is an 86-character URL-safe string. Treat it like a password: it grants full access to the project it's scoped to.

<your-project-api-key>

TIP

Tip: Check API Schemas for the request header pattern.

Listing your keys

machina credentials list --project <project_id>

Keys are masked by default. Add --show-keys to reveal full values, or --copy <name> to copy one straight to your clipboard.

Revoking a key

machina credentials revoke <key_id>

In Studio, the Default API Key can't be revoked from the UI — the revoke action is hidden for it. Keys you create yourself can be revoked from either Studio or the CLI.

Next up

Explore Machina API endpoints for interacting with agents, documents and workflows using a customized integration.