Project domains

Create a ProjectDomain receive test

Creates a per-address receive-test token for forwarding/full-receive readiness. Send an email containing the token to the returned address through the external route; the inbound pipeline marks the test passed when it receives the message.

post/projects/v1/{project_id}/domains/{domain}/actions/test_receive

Request

Base URL: https://api.run402.com
URL: https://api.run402.com/projects/v1/{project_id}/domains/{domain}/actions/test_receive
Auth: one of:
- API key in header SIGN-IN-WITH-X
- HTTP bearer
- HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

Target project id. Authorization is checked server-side through wallet SIWX, control-plane session, or scoped grant key.

domainstring required

Example:kysigned.com

Lowercase DNS name to bind to the project.

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

tostring required

Desired local part or address, such as info or info@kysigned.com.

Response

Receive test created

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

domainstring required

status'action_required' | 'waiting' | 'active' | 'needs_repair' | 'failed' required

created_atstring date-time

updated_atstring date-time

Example response

{
  "project_id": "prj_1741340000_0042",
  "domain": "kysigned.com",
  "desired": {
    "web": {
      "target": "production"
    }
  },
  "next_actions": [
    {
      "method": "POST",
      "path": "/tiers/v1/hobby",
      "auth": "x402"
    }
  ],
  "next_action": {
    "method": "POST",
    "path": "/tiers/v1/hobby",
    "auth": "x402"
  },
  "alternate_actions": [
    {
      "method": "POST",
      "path": "/tiers/v1/hobby",
      "auth": "x402"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.