# CustomDomain Agents API

**Canonical:** https://apis.io/apis/customdomain-ai/customdomain-ai-agents-api/  
**Provider:** CustomDomain — https://apis.io/providers/customdomain-ai/  
**Base URL:** https://api.customdomain.ai/v1  
**Documentation:** https://docs.customdomain.ai/docs/api-reference

CustomDomain Agents API is one of 25 APIs that [CustomDomain](https://apis.io/providers/customdomain-ai/) 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 Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

AI assistants acting for a workspace. An agent registers, a person approves what it may do in the console, and it works with a short lived token until the grant is revoked. The hosted MCP server accepts these tokens. The authorization server metadata (RFC 8414) and the signing keys (RFC 7517) are served on the API origin at `/.well-known/oauth-authorization-server` and `/.well-known/jwks.json`.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/oauth/agent/register` | Register an agent as an OAuth client |
| GET | `/oauth/agent/authorize` | Start an agent authorization (code with PKCE) |
| POST | `/oauth/agent/token` | Exchange an authorization code or a refresh token for an access token |
| POST | `/oauth/agent/revoke` | Revoke an agent's access with its refresh token |
| GET | `/agent/consent-request/{id}` | Read a pending agent authorization, for the consent screen |
| DELETE | `/agent/consent-request/{id}` | Deny a pending agent authorization |
| POST | `/agent/consent` | Approve an agent and mint its authorization code |
| GET | `/agent/grants` | List the workspace's agent grants |
| DELETE | `/agent/grants/{id}` | Revoke an agent's access |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/customdomain-ai/openapi/customdomain-ai-agents-api-openapi.yml
- **Documentation** — https://docs.customdomain.ai/docs/api-reference
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-consent-approval-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-consent-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-client-registration-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-token-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-client-schema.json
- **JSONSchema** — https://artifacts.apis.io/customdomain-ai/json-schema/customdomain-ai-agent-token-response-schema.json

## Other CustomDomain APIs (12)

- [CustomDomain MCP Server](https://apis.io/apis/customdomain-ai/mcp-server/)
- [CustomDomain Analytics API](https://apis.io/apis/customdomain-ai/customdomain-ai-analytics-api/)
- [CustomDomain Applications API](https://apis.io/apis/customdomain-ai/customdomain-ai-applications-api/)
- [CustomDomain Billing API](https://apis.io/apis/customdomain-ai/customdomain-ai-billing-api/)
- [CustomDomain Cloud browser API](https://apis.io/apis/customdomain-ai/customdomain-ai-cloud-browser-api/)
- [CustomDomain Connect API](https://apis.io/apis/customdomain-ai/customdomain-ai-connect-api/)
- [CustomDomain Connections API](https://apis.io/apis/customdomain-ai/customdomain-ai-connections-api/)
- [CustomDomain Domains API](https://apis.io/apis/customdomain-ai/customdomain-ai-domains-api/)
- [CustomDomain Enterprise API](https://apis.io/apis/customdomain-ai/customdomain-ai-enterprise-api/)
- [CustomDomain Managed DNS API](https://apis.io/apis/customdomain-ai/customdomain-ai-managed-dns-api/)
- [CustomDomain Members API](https://apis.io/apis/customdomain-ai/customdomain-ai-members-api/)
- [CustomDomain Meta API](https://apis.io/apis/customdomain-ai/customdomain-ai-meta-api/)

## Tags

Agents

---

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