---
title: Activate an instant stub listing for an unlisted domain
description: >-
  Re-validates https://{domain}/.well-known/releases.json server-side, then
  creates a stub org (basis: declared) for an unlisted domain.
---
# Activate an instant stub listing for an unlisted domain

`POST https://api.releases.sh/v1/listing/activate`

Re-validates https://{domain}/.well-known/releases.json server-side, then creates a stub org (basis: declared) for an unlisted domain. Already-stub domains take no write except an optional tracking-request stamp; tracked domains 409 with the org pointer. Public and anonymous; rate limited per IP and per domain.

**Auth:** optional Bearer token.

**Request body** (`application/json`)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes |  |
| `requestTracking` | boolean | no |  |

**Responses**

- `200` Existing stub; tracking stamp updated
- `201` Stub created
- `400` Manifest invalid or unfetchable
- `404` Lane disabled
- `409` Domain already listed (tracked)
- `429` Rate limited

Full request and response schemas: [OpenAPI 3.1 spec](https://api.releases.sh/v1/openapi.json).