Using the API with Claude

1. Allow Consio in Claude (organization admin)

Claude runs code and HTTP requests inside a sandbox. By default, only package managers are allowed. To reach Consio, an organization admin must add the API domain to the allowlist:

Open Organization settings
Go to Capabilities → Domain allowlist
Under Additional allowed domains, add:
```
api.consio.ai
```
Save the change.

Without this step, Claude cannot reach https://api.consio.ai and API calls will fail.

2. Create a Consio API key

Each request is authenticated with a workspace API key.

Sign in to Consio
Open your workspace
Go to Settings → API keys
Click Create API key
Copy the key immediately—it starts with csk_ and is shown only once

Store the key securely. Revoke it from the same page if it is exposed.

3. Using Claude

Share the following with Claude in your conversation:

Your API key (csk_…)
Your workspace slug
The Consio API documentation: https://consio-developers.readme.io

Claude can read the documentation to learn available endpoints, request formats, and response schemas. Example prompt:

"Here is my Consio API key and workspace slug acme. Use the documentation at https://consio-developers.readme.io to list my 10 most recent completed calls."

Tips:

Do not commit API keys to code repositories.
If your Claude plan supports secrets, store the API key there instead of pasting it in plain text.

Troubleshooting

Symptom	Likely cause
Network / connection error from Claude	`api.consio.ai` not in the organization domain allowlist
`401 Could not validate API key`	Invalid, revoked, or wrong key; or key does not match the workspace slug in the URL
`403 Inactive user`	The user who created the key was deactivated

For API issues, contact [email protected].