---
title: "Register Dome"
method: POST
path: "/v1/webhooks/register-dome"
tags: ["Dome", "webhooks"]
---

# Register Dome

`POST /v1/webhooks/register-dome`

Register a Dome instance URL for an agent (called by Dome at runtime).

Idempotent: safe to call on every Dome restart; each call overwrites the
stored dome_url for that agent's config.

## Headers

- `X-Webhook-Api-Key` string, nullable

## Request body

- RegisterDomeRequest — Request body for register-dome webhook.
  - `agent_id` string, uuid, required — The agent being protected
  - `team_id` string, uuid, required — Team that owns the agent
  - `dome_url` string, uri, required — Base URL of the Dome instance

## Response `200`

Successful Response

- RegisterDomeResponse — Success response for register-dome webhook.
  - `status` string
  - `agent_id` string, uuid, required
  - `team_id` string, uuid, required
  - `dome_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/versions/a8b2ee2b2d06/schema)