apphost.site.get

Fetch a single hosted site (by site_uuid or identity_app_uuid) with its serving URL

Get one HostedSite by site_uuid or identity_app_uuid, org-scoped.

Overview

Property	Value
Workflow type	Atomic
Library	App-apphost
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Org that owns the site; rows outside it read as not found
site_uuid	uuid	No	—	Lookup by hosted_site uuid (this or identity_app_uuid is required)
identity_app_uuid	uuid	No	—	Lookup by the identity app the site authenticates against

Output Schema

Field	Type	Required	Default	Description
site	json	No	—	Site projection — uuids, slug, mode, url, active_release_uuid, timestamps
found	boolean	No	—	—
error	string	No	—	—
error_type	string	No	—	Error-as-field envelope populated when query() raises.

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

Outcomes

Outcome	Type	Description	State Data Keys
read	SUCCESS	Hosted site projection returned	site_uuid
failed	FAILURE	Apphost workflow failed	failure_reason

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "apphost.site.get",
  "initial_data": {
    "organization_uuid": "value"
  }
}