Apply

Resolve stable host/path diagnostics

Diagnose how a project-owned stable host and path resolve against the current live release. Returns binding status, release id/generation, route and static manifest SHAs, static manifest metadata, normalized path, match kind, static SHA, cache class/policy, CAS authorization result, response variant diagnostics when applicable, fallback state, legacy immutable risk, edge_propagation diagnostics for eventually consistent edge stores, and result status. A deployment host of the project adds deployment_status (live, retained or retired), origin_available_until and routes_active, and resolves the path against the deployment's release. Does not expose internal CAS URLs.

get/apply/v1/resolve

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/apply/v1/resolve
  • Auth: API key in header apikey

Query parameters

hoststring required

Public host to resolve, such as a claimed run402.com subdomain, an active custom domain, or a deployment host (dpl-*.sites.run402.com).

pathstring

Raw public URL path. Defaults to /.

methodstring

HTTP method to evaluate for static lookup and SPA fallback eligibility. Defaults to GET.

Response

Stable-host resolution diagnostics. Host misses are represented as result=404 in the response body.

hostnamestring required
host_binding_idstring nullable
binding_statusstring nullable
project_idstring nullable
channelstring nullable
release_idstring nullable
release_generationinteger nullable
route_manifest_sha256string nullable
static_manifest_sha256string nullable
normalized_pathstring nullable
current_host_release_idstring nullable
current_host_release_generationinteger nullable
match'host_missing' | 'manifest_missing' | 'active_release_missing' | 'unsupported_manifest_version' | 'path_error' | 'none' | 'route_function' | 'route_static_alias' | 'route_method_miss' | 'static_exact' | 'static_index' | 'spa_fallback' | 'retained_public_path' | 'spa_fallback_missing' | 'deployment_host' | 'deployment_retired' required
static_sha256string nullable
asset_pathstring nullable

Private release static asset path backing the matched public path. Present only on authenticated diagnostics.

reachability_authority'implicit_file_path' | 'explicit_public_path' | 'route_static_alias' | 'null' nullable
directboolean nullable
content_typestring nullable
cache_class'html' | 'immutable_versioned' | 'revalidating_asset' | 'null' nullable
cache_policystring nullable
authorizedboolean required
authorization_result'authorized' | 'not_public' | 'not_applicable' | 'manifest_missing' | 'target_missing' | 'active_release_missing' | 'unsupported_manifest_version' | 'path_error' | 'missing_cas_object' | 'unfinalized_or_deleting_cas_object' | 'size_mismatch' | 'unauthorized_cas_object' | 'route_inactive' | 'null' nullable

Static CAS authorization/health result when a static object was matched, or the reason no static object is authorized.

fallback_state'unavailable' | 'active_release_missing' | 'unsupported_manifest_version' | 'negative_cache_hit' | 'path_error' | 'method_not_static' | 'not_used' | 'target_missing' | 'used' | 'not_configured' | 'not_eligible' required
error_codestring nullable
legacy_immutable_riskobject[]
noindexboolean

Whether the release this host serves declared site.noindex (every response carries X-Robots-Tag: noindex, nofollow, nosnippet).

emergency_fallbackobject
allowstring[] nullable
route_patternstring nullable
target_type'function' | 'static' | 'null' nullable
target_namestring nullable
target_filestring nullable
host_kindstring nullable

deployment when the host is a deployment host (dpl-*.sites.run402.com); absent for stable hosts.

deployment_idstring nullable

Deployment hosts: the dpl_ deployment the host serves.

deployment_status'live' | 'retained' | 'retired' nullable

Deployment hosts: live while the active release or a subdomain serves the deployment, retained once replaced (serving until origin_available_until), retired after that deadline (every request answers 404).

origin_available_untilstring date-time nullable

Deployment hosts: when a replaced deployment stops (or stopped) serving; null while live.

origin_retention_secondsinteger nullable

Deployment hosts: how long a replaced deployment keeps serving (3600).

path_evaluatedboolean

Deployment hosts: true when the path was resolved against the deployment's release (its static manifest and public paths); false for a retired host or a deployment no release names, reported per host.

route_gatesstring[]

Function routes: what stands before the function's response (require_auth, require_role, priced); empty when anyone reaches it. authorized: true on a function route means the host dispatches the request to the function.

routes_activeboolean

Deployment hosts: false once the deployment was replaced; its routes no longer run there and a matched route reports result 404.

resultinteger required

Changes

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