Project domains

Patch project domain desired state

Merges a desired-state patch into an existing ProjectDomain, then recomputes observed/effective state.

patch/projects/v1/{project_id}/domains/{domain}

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/domains/{domain}
  • 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

Example request

{
  "desired": {
    "web": {
      "target": "production"
    }
  }
}

Response

ProjectDomain updated

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.