
Overview
IO Intelligence APIs provide programmatic access to powerful AI models and agents. Before making API requests, credentials must be configured correctly to authenticate calls. This section explains how to create, manage, and use both API Keys and Secrets in IO Intelligence.API Keys
What are API Keys?
API keys are authentication credentials that allow applications to securely interact with IO Intelligence APIs. They are required when accessing model inference endpoints, agent workflows, or other programmatic services.Creating API Keys
Use the following steps to create a new API key within the API Keys and Secrets tab.The API key will only be displayed once. Store it securely, as it cannot be shown again.
1
Navigate to the API Keys and Secrets tab
2
Click Create New API Key
3
Fill in the New API Key Form
4
Confirm and Save
Managing API Keys
In the API Keys and Secrets tab, you can manage your API keys to control access to IO Intelligence APIs and maintain secure usage over time.- Search: Use the search bar to quickly locate existing API keys by name, which is especially useful when managing multiple keys.
- Edit: Update an API key’s name or permissions to reflect changes in how the key is used, such as limiting access or aligning it with a specific workflow.
- Revoke: Revoke API keys that are no longer needed to immediately disable further use and reduce security risk.
- Expiration: Configure or review expiration settings so API keys are automatically invalidated after a defined period.
Secrets
What are Secrets?
Secrets are credentials or tokens required by certain agents or integrations, especially when interacting with third-party services, for example, GitHub, Jira, Linear, or other external APIs. These secrets enable authenticated access on your behalf and must be configured securely.Creating Secrets
There are two ways to create a new secret, through the API Keys and Secrets tab or from within an Agent’s configuration.- API Keys and Secrets Tab
- Agent Details View
To create a Secret from the API Keys and Secrets Tab, follow these steps:
1
Open the API Keys and Secrets tab
2
Click the Add Secret button
3
Enter your Secret Details
4
Save your Secret
Secrets created here are stored securely and will be available for use across agents.
Managing Secrets
The API Keys and Secrets tab provides a centralized view of all secrets created within io.net Intelligence. From here, existing secrets can be reviewed and deleted when they are no longer in use. Deleting a secret immediately removes it and prevents it from being used by any agent or integration.Using API Keys and Secrets
API keys must be included in the Authorization header of all requests to IO Intelligence APIs. For example:Replace
$IOINTELLIGENCE_API_KEY with your actual API key.FAQs
How do I secure my API Key?
How do I secure my API Key?
Some best practices and tips:
- Do not share your API key publicly.
- Use environment variables to store API keys securely.
- Rotate your API keys periodically.
What is the difference between an API key and a secret?
What is the difference between an API key and a secret?
API keys authenticate requests to io.net Intelligence APIs, while secrets authenticate access to third-party services or integrations required by certain agents.
What do I do if a secret is compromised?
What do I do if a secret is compromised?
Revoke or rotate the secret immediately from the API Keys and Secrets tab.
What are the rate limits for the APIs?
What are the rate limits for the APIs?
The IO Intelligence API offers different quotas, depending on your io.net Intelligence Payment Plan. Refer to IO Intelligence Payment for more information.