# KnoxCall AI Gateway API

**Canonical:** https://apis.io/apis/knoxcall/knoxcall-ai-gateway-api/  
**Provider:** KnoxCall — https://apis.io/providers/knoxcall/  
**Base URL:** https://api.knoxcall.com/v1  
**Documentation:** https://docs.knoxcall.com/api-reference

KnoxCall AI Gateway API is one of 24 APIs that [KnoxCall](https://apis.io/providers/knoxcall/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include AI Gateway. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Manage AI egress gateways, their agents, and capability (phantom) tokens, plus cost/token spend rollups and FinOps exports.

## Operations (49)

| Method | Path | Summary |
|---|---|---|
| GET | `/ai-gateway/gateways` | List AI gateways |
| POST | `/ai-gateway/gateways` | Create an AI gateway |
| GET | `/ai-gateway/gateways/{id}` | Get an AI gateway |
| PATCH | `/ai-gateway/gateways/{id}` | Update an AI gateway |
| DELETE | `/ai-gateway/gateways/{id}` | Archive an AI gateway |
| GET | `/ai-gateway/gateways/{gatewayId}/agents` | List a gateway's agents |
| POST | `/ai-gateway/gateways/{gatewayId}/agents` | Create an agent |
| GET | `/ai-gateway/agents/{id}` | Get an agent |
| PATCH | `/ai-gateway/agents/{id}` | Update an agent |
| DELETE | `/ai-gateway/agents/{id}` | Archive an agent |
| GET | `/ai-gateway/agents/{agentId}/tokens` | List an agent's capability tokens |
| POST | `/ai-gateway/agents/{agentId}/tokens` | Mint a capability token |
| DELETE | `/ai-gateway/agents/{agentId}/tokens/{tokenId}` | Revoke a capability token |
| GET | `/ai-gateway/gateways/{gatewayId}/tokens` | List every token under a gateway |
| DELETE | `/ai-gateway/gateways/{gatewayId}/tokens/{tokenId}` | Revoke a token under a gateway |
| GET | `/ai-gateway/gateways/{gatewayId}/mcp-servers` | List a gateway's MCP servers |
| POST | `/ai-gateway/gateways/{gatewayId}/mcp-servers` | Register an MCP server |
| GET | `/ai-gateway/mcp-servers/{id}` | Get an MCP server |
| PATCH | `/ai-gateway/mcp-servers/{id}` | Update an MCP server |
| DELETE | `/ai-gateway/mcp-servers/{id}` | Archive an MCP server |
| GET | `/ai-gateway/mcp-servers/{id}/grants` | List the delegated-OAuth connections on an MCP server |
| DELETE | `/ai-gateway/mcp-servers/{id}/grants` | Revoke every delegated-OAuth connection on an MCP server |
| DELETE | `/ai-gateway/mcp-servers/{id}/grants/{grantId}` | Revoke one person's delegated-OAuth connection |
| GET | `/ai-gateway/mcp-servers/{id}/tools` | List an MCP server's tool rows |
| POST | `/ai-gateway/mcp-servers/{id}/tools` | Upsert an MCP tool row |
| PATCH | `/ai-gateway/mcp-servers/{id}/tools/{toolId}` | Enable, disable or re-describe a tool row |
| DELETE | `/ai-gateway/mcp-servers/{id}/tools/{toolId}` | Delete a tool row |
| GET | `/ai-gateway/usage/export` | Export AI gateway usage (FinOps) |
| GET | `/ai-gateway/usage` | Get AI gateway usage |
| GET | `/ai-gateway/firewall-policies` | List prompt-firewall policies |
| POST | `/ai-gateway/firewall-policies` | Create a prompt-firewall policy |
| POST | `/ai-gateway/firewall-policies/test` | Dry-run firewall rules against sample text |
| GET | `/ai-gateway/firewall-policies/{id}` | Get a prompt-firewall policy |
| PATCH | `/ai-gateway/firewall-policies/{id}` | Update a prompt-firewall policy |
| DELETE | `/ai-gateway/firewall-policies/{id}` | Delete a prompt-firewall policy |
| GET | `/ai-gateway/pii-policies` | List PII redaction policies |
| POST | `/ai-gateway/pii-policies` | Create a PII redaction policy |
| GET | `/ai-gateway/pii-policies/{id}` | Get a PII redaction policy |
| PATCH | `/ai-gateway/pii-policies/{id}` | Update a PII redaction policy |
| DELETE | `/ai-gateway/pii-policies/{id}` | Delete a PII redaction policy |
| GET | `/ai-gateway/pii-recognizers` | List custom PII recognizers |
| POST | `/ai-gateway/pii-recognizers` | Create a custom PII recognizer |
| POST | `/ai-gateway/pii-recognizers/test` | Dry-run a recognizer pattern against sample text |
| GET | `/ai-gateway/pii-recognizers/{id}` | Get a custom PII recognizer |
| PATCH | `/ai-gateway/pii-recognizers/{id}` | Update a custom PII recognizer |
| DELETE | `/ai-gateway/pii-recognizers/{id}` | Delete a custom PII recognizer |
| POST | `/v1/oauth/token` | Exchange a CI OIDC token for an AI-gateway capability token |
| POST | `/v1/ai/{agentSlug}/{upstreamPath}` | Call an AI provider through the gateway |
| GET | `/v1/ai/{agentSlug}/{upstreamPath}` | Read from an AI provider through the gateway |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/openapi/knoxcall-ai-gateway-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-create-ai-gateway-agent-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-ai-gateway-agent-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-update-ai-gateway-agent-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-ai-gateway-mcp-server-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-request-log-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/knoxcall/refs/heads/main/json-schema/knoxcall-create-webhook-request-schema.json

## Other KnoxCall APIs (12)

- [KnoxCall Account API](https://apis.io/apis/knoxcall/knoxcall-account-api/)
- [KnoxCall Agents API](https://apis.io/apis/knoxcall/knoxcall-agents-api/)
- [KnoxCall API Keys API](https://apis.io/apis/knoxcall/knoxcall-api-keys-api/)
- [KnoxCall Audit Logs API](https://apis.io/apis/knoxcall/knoxcall-audit-logs-api/)
- [KnoxCall Client Tokens API](https://apis.io/apis/knoxcall/knoxcall-client-tokens-api/)
- [KnoxCall Clients API](https://apis.io/apis/knoxcall/knoxcall-clients-api/)
- [KnoxCall Crypto Keys API](https://apis.io/apis/knoxcall/knoxcall-crypto-keys-api/)
- [KnoxCall Dynamic DB Credentials API](https://apis.io/apis/knoxcall/knoxcall-dynamic-db-credentials-api/)
- [KnoxCall Encryption API](https://apis.io/apis/knoxcall/knoxcall-encryption-api/)
- [KnoxCall Environments API](https://apis.io/apis/knoxcall/knoxcall-environments-api/)
- [KnoxCall Ephemeral Proxy API](https://apis.io/apis/knoxcall/knoxcall-ephemeral-proxy-api/)
- [KnoxCall OAuth Clients API](https://apis.io/apis/knoxcall/knoxcall-oauth-clients-api/)

## Tags

AI Gateway

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/knoxcall/knoxcall-ai-gateway-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/knoxcall/.