Copy page

Core Concepts

Access and Permissions

Access to the IntelCenter API is controlled at the API key level.

Permissions determine which datasets, entities, and features are available.

---

Permission Types

API keys may be restricted by:

Dataset Access

• ICD datasets (curated content)
• ICDB datasets (expanded content)

Some keys may have access to only ICD, while others include ICDB.

---

Entity-Level Access

For ICDB datasets, access may be limited to specific entities.

Example:

• A key may only return results for a defined list of entities
• Requests outside those entities will return no results or be blocked

---

Feature Access

Some API keys may have restricted access to:

• Natural Language Search
• Domain GenAI

---

Example Restriction Behavior

If an API key does not have access to a dataset or feature, the API will return:

Code
{
  "error": "FORBIDDEN",
  "message": "You do not have access to this dataset or feature."
}

---

Important Notes

• Permissions are enforced automatically at the gateway level
• MCP endpoints respect the same access rules
• Entity restrictions apply across all related endpoints

---

Troubleshooting

If you receive a 403 Forbidden response:

1. Confirm your API key has access to the dataset
2. Check if entity-level restrictions apply
3. Verify access to Natural Language or Domain GenAI features

---

Need Expanded Access?

Contact IntelCenter to upgrade your API key permissions:

[email protected]