# Public Api

## GET /public-api/v1/org/{orgId}/custom-domains

> List custom domains for an organization

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains":{"get":{"responses":{},"parameters":[{"schema":{"type":"integer","default":1,"minimum":1},"name":"page","in":"query"},{"schema":{"type":"integer","default":25,"maximum":100,"minimum":1},"name":"pageSize","in":"query"},{"schema":{"type":"string","enum":["pending","active","pending_ssl","moved","failed"]},"name":"status","in":"query"},{"schema":{"type":"string"},"name":"orgId","in":"path"}],"operationId":"listCustomDomains","summary":"List custom domains for an organization"}}}}
```

## POST /public-api/v1/org/{orgId}/custom-domains

> Create a custom domain via Cloudflare

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains":{"post":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"}],"operationId":"createCustomDomain","summary":"Create a custom domain via Cloudflare","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"defaultRedirectUrl":{"type":"string"}},"required":["domain","defaultRedirectUrl"],"additionalProperties":false}}}}}}}}
```

## GET /public-api/v1/org/{orgId}/custom-domains/{customDomainId}

> Get custom domain details with DNS records

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}":{"get":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"getCustomDomainDetail","summary":"Get custom domain details with DNS records"}}}}
```

## PUT /public-api/v1/org/{orgId}/custom-domains/{customDomainId}

> Update the default redirect URL of a custom domain

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}":{"put":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"updateCustomDomain","summary":"Update the default redirect URL of a custom domain","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"defaultRedirectUrl":{"type":"string"}},"required":["defaultRedirectUrl"],"additionalProperties":false}}}}}}}}
```

## DELETE /public-api/v1/org/{orgId}/custom-domains/{customDomainId}

> Delete a custom domain

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}":{"delete":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"deleteCustomDomain","summary":"Delete a custom domain"}}}}
```

## Trigger DNS verification for a custom domain

> Initiates DNS ownership and SSL verification checks. Idempotent — can be called multiple times to refresh the verification status.

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}/verify":{"put":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"verifyCustomDomain","summary":"Trigger DNS verification for a custom domain","description":"Initiates DNS ownership and SSL verification checks. Idempotent — can be called multiple times to refresh the verification status."}}}}
```

## GET /public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings

> List path mappings for a custom domain

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings":{"get":{"responses":{},"parameters":[{"schema":{"type":"integer","default":1,"minimum":1},"name":"page","in":"query"},{"schema":{"type":"integer","default":25,"maximum":100,"minimum":1},"name":"pageSize","in":"query"},{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"listPathMappings","summary":"List path mappings for a custom domain"}}}}
```

## POST /public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings

> Create a path mapping for a custom domain

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings":{"post":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"}],"operationId":"createPathMapping","summary":"Create a path mapping for a custom domain","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"eventId":{"type":"string"},"eventRegFormId":{"type":"string"},"pathName":{"type":"string"}},"required":["eventId","pathName"],"additionalProperties":false}}}}}}}}
```

## PUT /public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings/{pathMappingId}

> Update a path mapping

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings/{pathMappingId}":{"put":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"},{"schema":{"type":"string"},"name":"pathMappingId","in":"path"}],"operationId":"updatePathMapping","summary":"Update a path mapping","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"eventId":{"type":"string"},"eventRegFormId":{"type":["string","null"]},"pathName":{"type":"string"}},"additionalProperties":false}}}}}}}}
```

## DELETE /public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings/{pathMappingId}

> Delete a path mapping

```json
{"openapi":"3.1.1","info":{"title":"Public Api","version":"beta"},"servers":[{"url":"/"}],"paths":{"/public-api/v1/org/{orgId}/custom-domains/{customDomainId}/path-mappings/{pathMappingId}":{"delete":{"responses":{},"parameters":[{"schema":{"type":"string"},"name":"orgId","in":"path"},{"schema":{"type":"string"},"name":"customDomainId","in":"path"},{"schema":{"type":"string"},"name":"pathMappingId","in":"path"}],"operationId":"deletePathMapping","summary":"Delete a path mapping"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eventx-hq.gitbook.io/knowledge-base/api-doc/public-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.