Open source / Rust / MIT Field guide / indexed
Field guide / Platform APIReviewable source / main

Platform API

Platform status and bootstrap surface: the liveness/readiness/metrics probes registered outside /api, plus platform summary, uptime, degradation drills, and database-readiness reads. The summary read is auth-exempt so the login view can bootstrap before a session exists.

34 routes

Response metadata: x-api-version, x-request-id, and traceresponse apply to normal routed responses and are omitted from the per-operation header tables below.

GET/api/platform/database-readiness-contract

request access

Platform database readiness.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/database-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
databaseProviderstringRequiredValue of databaseProvider returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
kubernetesApplyAllowedbooleanRequiredValue of kubernetesApplyAllowed returned in the response body.
cnpgClusterCreationAllowedbooleanRequiredValue of cnpgClusterCreationAllowed returned in the response body.
databaseMutationAllowedbooleanRequiredValue of databaseMutationAllowed returned in the response body.
schemaMigrationAllowedbooleanRequiredValue of schemaMigrationAllowed returned in the response body.
backupExecutionAllowedbooleanRequiredValue of backupExecutionAllowed returned in the response body.
restoreExecutionAllowedbooleanRequiredValue of restoreExecutionAllowed returned in the response body.
objectStorageAccessAllowedbooleanRequiredValue of objectStorageAccessAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
connectionStringsAllowedbooleanRequiredValue of connectionStringsAllowed returned in the response body.
rawDatabaseRowsAllowedbooleanRequiredValue of rawDatabaseRowsAllowed returned in the response body.
rawBackupPayloadsAllowedbooleanRequiredValue of rawBackupPayloadsAllowed returned in the response body.
rawKubernetesPayloadsAllowedbooleanRequiredValue of rawKubernetesPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/database-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "databaseProvider": "<string>",
  "providerCallsEnabled": false,
  "kubernetesApplyAllowed": false,
  "cnpgClusterCreationAllowed": false,
  "databaseMutationAllowed": false,
  "schemaMigrationAllowed": false,
  "backupExecutionAllowed": false,
  "restoreExecutionAllowed": false,
  "objectStorageAccessAllowed": false,
  "credentialValuesAllowed": false,
  "connectionStringsAllowed": false,
  "rawDatabaseRowsAllowed": false,
  "rawBackupPayloadsAllowed": false,
  "rawKubernetesPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "readinessSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/degradation-contract

request access

Degradation contract.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/degradation-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/degradation-contract'

POST/api/platform/degradation/check/{site}

admin access

Degradation check.

Permissions

Access classCredentialScoping
adminAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

POST https://<your-host>/api/platform/degradation/check/{site}

Path parameters

NameTypeRequirementDescription
sitestringRequiredValue of the site request-path segment.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
Idempotency-KeystringOptionalOptional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  'https://<your-host>/api/platform/degradation/check/<site>'

GET/api/platform/degradation/degraded

audit access

Degradation degraded.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/degradation/degraded

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/degradation/degraded'

POST/api/platform/degradation/enter/{site}

admin access

Degradation enter.

Permissions

Access classCredentialScoping
adminAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

POST https://<your-host>/api/platform/degradation/enter/{site}

Path parameters

NameTypeRequirementDescription
sitestringRequiredValue of the site request-path segment.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
Content-TypestringRequiredRequired by the resolved Axum Json<T> request extractor; send application/json.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
Idempotency-KeystringOptionalOptional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

JSON structure: DegradationEnterRequest.

NameTypeRequirementDescription
reasonstringRequiredHuman-readable reason recorded with the operation and its audit trail.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '{"reason":"<string>"}' \
  'https://<your-host>/api/platform/degradation/enter/<site>'

POST/api/platform/degradation/exit/{site}

admin access

Degradation exit.

Permissions

Access classCredentialScoping
adminAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

POST https://<your-host>/api/platform/degradation/exit/{site}

Path parameters

NameTypeRequirementDescription
sitestringRequiredValue of the site request-path segment.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
Idempotency-KeystringOptionalOptional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request POST \
  --header 'Authorization: Bearer <token>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  'https://<your-host>/api/platform/degradation/exit/<site>'

GET/api/platform/degradation/global

audit access

Degradation global.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/degradation/global

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/degradation/global'

GET/api/platform/degradation/rules

audit access

Degradation rules.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/degradation/rules

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/degradation/rules'

GET/api/platform/design-system-contract

request access

Platform design system.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/design-system-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
designModestringRequiredValue of designMode returned in the response body.
lightModeRequiredbooleanRequiredValue of lightModeRequired returned in the response body.
darkModeRequiredbooleanRequiredValue of darkModeRequired returned in the response body.
accessibilityReviewRequiredbooleanRequiredValue of accessibilityReviewRequired returned in the response body.
evidenceSafetyRequiredbooleanRequiredValue of evidenceSafetyRequired returned in the response body.
liveThemeMutationAllowedbooleanRequiredValue of liveThemeMutationAllowed returned in the response body.
externalFontFetchAllowedbooleanRequiredValue of externalFontFetchAllowed returned in the response body.
unsafeErrorDetailAllowedbooleanRequiredValue of unsafeErrorDetailAllowed returned in the response body.
rawUiDiagnosticRowsAllowedbooleanRequiredValue of rawUiDiagnosticRowsAllowed returned in the response body.
rawEvidencePayloadsAllowedbooleanRequiredValue of rawEvidencePayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
accessTokenValuesAllowedbooleanRequiredValue of accessTokenValuesAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
brandTokensarray<JSON value>RequiredValue of brandTokens returned in the response body.
designSurfacesarray<JSON value>RequiredValue of designSurfaces returned in the response body.
statusFamiliesarray<JSON value>RequiredValue of statusFamilies returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/design-system-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "designMode": "<string>",
  "lightModeRequired": false,
  "darkModeRequired": false,
  "accessibilityReviewRequired": false,
  "evidenceSafetyRequired": false,
  "liveThemeMutationAllowed": false,
  "externalFontFetchAllowed": false,
  "unsafeErrorDetailAllowed": false,
  "rawUiDiagnosticRowsAllowed": false,
  "rawEvidencePayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "credentialValuesAllowed": false,
  "secretValuesAllowed": false,
  "accessTokenValuesAllowed": false,
  "rawRecipientDataAllowed": false,
  "brandTokens": [],
  "designSurfaces": [],
  "statusFamilies": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/health

audit access

Platform health.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health'

GET/api/platform/health/adapters

audit access

Platform health adapters.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/adapters

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
adaptersJSON valueRequiredValue of adapters returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/adapters'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "adapters": null
}

GET/api/platform/health/all

audit access

Component health checks.

These are SIMULATED (the health_monitor engine is pure / IO-free), so the overall status is NOT a live truth signal. The response is marked advisory and points at the real dependency-backed probe (#6) so a monitoring system can never mistake a hardcoded healthy for a live one (swarm finding #4). Additive: the original PlatformHealth fields are unchanged.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/all

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

For 200, the known response body type is Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/all'

GET/api/platform/health/check/{adapter}

audit access

Platform health check adapter.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/check/{adapter}

Path parameters

NameTypeRequirementDescription
adapterstringRequiredValue of the adapter request-path segment.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKryuki_engine::health_monitor::HealthCheck

200 response body

Structure: ryuki_engine::health_monitor::HealthCheck.

NameTypeRequirementDescription
namestringRequiredValue of name returned in the response body.
componentstringRequiredValue of component returned in the response body.
statusobject (HealthStatus)RequiredCurrent operation or resource status.
sourceobject (HealthSource)RequiredOrigin or authority of the returned data.
last_checkstringRequiredValue of last_check returned in the response body.
messagestringRequiredHuman-readable error or result message.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/check/<adapter>'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "name": "<string>",
  "component": "<string>",
  "status": {},
  "source": {},
  "last_check": "<string>",
  "message": "<string>"
}

GET/api/platform/health/components

audit access

Platform health components.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/components

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourceJSON valueRequiredOrigin or authority of the returned data.
overall_statusJSON valueRequiredValue of overall_status returned in the response body.
timestampJSON valueRequiredValue of timestamp returned in the response body.
componentsJSON valueRequiredValue of components returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/components'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": null,
  "overall_status": null,
  "timestamp": null,
  "components": null
}

GET/api/platform/health/dependencies

audit access

Dependency-backed self-health (#6).

Unlike the binary /ready, this reports EACH backing dependency (database connectivity, migrations, scheduler liveness) and an aggregate verdict. Alerting-safe: a probe that errors is down (never silently healthy), and the aggregate maps to 200 (healthy/degraded — still serving) or 503 (unhealthy). Authenticated (it lives in the human-gated router).

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/dependencies

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

For 200, the known response body type is serde_json::Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/dependencies'

GET/api/platform/health/loops

audit access

Per-loop breakdown of the background-loop heartbeat registry.

The aggregate /api/platform/health/dependencies reports only THAT a loop is wedged; this reports WHICH loop, its cadence, how long it has been silent (age_secs), and its overdue threshold_secs, so an operator can diagnose. Authenticated like its sibling (it lives in the human-gated router; the loop names are already surfaced by the aggregate's down detail). A wedged loop maps to 503 (else 200); the body always carries the full breakdown.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/loops

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

For 200, the known response body type is serde_json::Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/loops'

GET/api/platform/health/metrics

audit access

Platform health metrics text.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/health/metrics

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKRaw or text response body

For 200, the operation returns a raw or text response body; no JSON shape applies.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/health/metrics'

GET/api/platform/kubernetes-runtime-readiness-contract

request access

Platform k8s runtime.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/kubernetes-runtime-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
runtimeProviderstringRequiredValue of runtimeProvider returned in the response body.
deploymentTargetstringRequiredValue of deploymentTarget returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
kubectlApplyAllowedbooleanRequiredValue of kubectlApplyAllowed returned in the response body.
helmInstallAllowedbooleanRequiredValue of helmInstallAllowed returned in the response body.
helmUpgradeAllowedbooleanRequiredValue of helmUpgradeAllowed returned in the response body.
kustomizeBuildAllowedbooleanRequiredValue of kustomizeBuildAllowed returned in the response body.
clusterMutationAllowedbooleanRequiredValue of clusterMutationAllowed returned in the response body.
namespaceMutationAllowedbooleanRequiredValue of namespaceMutationAllowed returned in the response body.
deploymentMutationAllowedbooleanRequiredValue of deploymentMutationAllowed returned in the response body.
serviceMutationAllowedbooleanRequiredValue of serviceMutationAllowed returned in the response body.
ingressMutationAllowedbooleanRequiredValue of ingressMutationAllowed returned in the response body.
networkPolicyMutationAllowedbooleanRequiredValue of networkPolicyMutationAllowed returned in the response body.
serviceAccountMutationAllowedbooleanRequiredValue of serviceAccountMutationAllowed returned in the response body.
sensitiveResourceMutationAllowedbooleanRequiredValue of sensitiveResourceMutationAllowed returned in the response body.
imagePullAllowedbooleanRequiredValue of imagePullAllowed returned in the response body.
registryAccessAllowedbooleanRequiredValue of registryAccessAllowed returned in the response body.
rawKubernetesPayloadsAllowedbooleanRequiredValue of rawKubernetesPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
kubeconfigValuesAllowedbooleanRequiredValue of kubeconfigValuesAllowed returned in the response body.
clusterIdentifiersAllowedbooleanRequiredValue of clusterIdentifiersAllowed returned in the response body.
sensitiveValuesAllowedbooleanRequiredValue of sensitiveValuesAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
ingressFrontTierProfilesarray<JSON value>RequiredValue of ingressFrontTierProfiles returned in the response body.
ingressRoutePosturesarray<JSON value>RequiredValue of ingressRoutePostures returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/kubernetes-runtime-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "runtimeProvider": "<string>",
  "deploymentTarget": "<string>",
  "providerCallsEnabled": false,
  "kubectlApplyAllowed": false,
  "helmInstallAllowed": false,
  "helmUpgradeAllowed": false,
  "kustomizeBuildAllowed": false,
  "clusterMutationAllowed": false,
  "namespaceMutationAllowed": false,
  "deploymentMutationAllowed": false,
  "serviceMutationAllowed": false,
  "ingressMutationAllowed": false,
  "networkPolicyMutationAllowed": false,
  "serviceAccountMutationAllowed": false,
  "sensitiveResourceMutationAllowed": false,
  "imagePullAllowed": false,
  "registryAccessAllowed": false,
  "rawKubernetesPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "kubeconfigValuesAllowed": false,
  "clusterIdentifiersAllowed": false,
  "sensitiveValuesAllowed": false,
  "readinessSurfaces": [],
  "ingressFrontTierProfiles": [],
  "ingressRoutePostures": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/local-container-readiness-contract

request access

Platform local container.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/local-container-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
runtimeProviderstringRequiredValue of runtimeProvider returned in the response body.
deploymentTargetstringRequiredValue of deploymentTarget returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
dockerComposeUpAllowedbooleanRequiredValue of dockerComposeUpAllowed returned in the response body.
dockerComposeBuildAllowedbooleanRequiredValue of dockerComposeBuildAllowed returned in the response body.
dockerRunAllowedbooleanRequiredValue of dockerRunAllowed returned in the response body.
imagePushAllowedbooleanRequiredValue of imagePushAllowed returned in the response body.
registryAccessAllowedbooleanRequiredValue of registryAccessAllowed returned in the response body.
serviceMutationAllowedbooleanRequiredValue of serviceMutationAllowed returned in the response body.
networkMutationAllowedbooleanRequiredValue of networkMutationAllowed returned in the response body.
portBindingMutationAllowedbooleanRequiredValue of portBindingMutationAllowed returned in the response body.
environmentValuesAllowedbooleanRequiredValue of environmentValuesAllowed returned in the response body.
envFileAllowedbooleanRequiredValue of envFileAllowed returned in the response body.
volumeMountsAllowedbooleanRequiredValue of volumeMountsAllowed returned in the response body.
providerServiceAllowedbooleanRequiredValue of providerServiceAllowed returned in the response body.
externalEgressAllowedbooleanRequiredValue of externalEgressAllowed returned in the response body.
rawRuntimePayloadsAllowedbooleanRequiredValue of rawRuntimePayloadsAllowed returned in the response body.
providerReturnedContentAllowedbooleanRequiredValue of providerReturnedContentAllowed returned in the response body.
sensitiveAuthValuesAllowedbooleanRequiredValue of sensitiveAuthValuesAllowed returned in the response body.
runtimeIdentifiersAllowedbooleanRequiredValue of runtimeIdentifiersAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/local-container-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "runtimeProvider": "<string>",
  "deploymentTarget": "<string>",
  "providerCallsEnabled": false,
  "dockerComposeUpAllowed": false,
  "dockerComposeBuildAllowed": false,
  "dockerRunAllowed": false,
  "imagePushAllowed": false,
  "registryAccessAllowed": false,
  "serviceMutationAllowed": false,
  "networkMutationAllowed": false,
  "portBindingMutationAllowed": false,
  "environmentValuesAllowed": false,
  "envFileAllowed": false,
  "volumeMountsAllowed": false,
  "providerServiceAllowed": false,
  "externalEgressAllowed": false,
  "rawRuntimePayloadsAllowed": false,
  "providerReturnedContentAllowed": false,
  "sensitiveAuthValuesAllowed": false,
  "runtimeIdentifiersAllowed": false,
  "readinessSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/object-storage-readiness-contract

request access

Platform object storage.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/object-storage-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
storageProviderstringRequiredValue of storageProvider returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
azureApiCallsAllowedbooleanRequiredValue of azureApiCallsAllowed returned in the response body.
storageAccountMutationAllowedbooleanRequiredValue of storageAccountMutationAllowed returned in the response body.
containerMutationAllowedbooleanRequiredValue of containerMutationAllowed returned in the response body.
blobReadWriteAllowedbooleanRequiredValue of blobReadWriteAllowed returned in the response body.
lifecyclePolicyMutationAllowedbooleanRequiredValue of lifecyclePolicyMutationAllowed returned in the response body.
immutabilityPolicyMutationAllowedbooleanRequiredValue of immutabilityPolicyMutationAllowed returned in the response body.
publicNetworkAccessAllowedbooleanRequiredValue of publicNetworkAccessAllowed returned in the response body.
sharedKeyUsageAllowedbooleanRequiredValue of sharedKeyUsageAllowed returned in the response body.
sasTokenValuesAllowedbooleanRequiredValue of sasTokenValuesAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
connectionStringsAllowedbooleanRequiredValue of connectionStringsAllowed returned in the response body.
rawBlobPayloadsAllowedbooleanRequiredValue of rawBlobPayloadsAllowed returned in the response body.
rawStoragePayloadsAllowedbooleanRequiredValue of rawStoragePayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
storageIdentifiersAllowedbooleanRequiredValue of storageIdentifiersAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/object-storage-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "storageProvider": "<string>",
  "providerCallsEnabled": false,
  "azureApiCallsAllowed": false,
  "storageAccountMutationAllowed": false,
  "containerMutationAllowed": false,
  "blobReadWriteAllowed": false,
  "lifecyclePolicyMutationAllowed": false,
  "immutabilityPolicyMutationAllowed": false,
  "publicNetworkAccessAllowed": false,
  "sharedKeyUsageAllowed": false,
  "sasTokenValuesAllowed": false,
  "credentialValuesAllowed": false,
  "connectionStringsAllowed": false,
  "rawBlobPayloadsAllowed": false,
  "rawStoragePayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "storageIdentifiersAllowed": false,
  "readinessSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/portal-information-architecture-contract

request access

Platform portal ia.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/portal-information-architecture-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
architectureModestringRequiredValue of architectureMode returned in the response body.
portalRuntimestringRequiredValue of portalRuntime returned in the response body.
browserIsolationRequiredbooleanRequiredValue of browserIsolationRequired returned in the response body.
stableNavigationRequiredbooleanRequiredValue of stableNavigationRequired returned in the response body.
sameOriginApiRoutingRequiredbooleanRequiredValue of sameOriginApiRoutingRequired returned in the response body.
ssrRequiredbooleanRequiredValue of ssrRequired returned in the response body.
hydrationRequiredbooleanRequiredValue of hydrationRequired returned in the response body.
serverFunctionBoundaryRequiredbooleanRequiredValue of serverFunctionBoundaryRequired returned in the response body.
browserProviderCallsAllowedbooleanRequiredValue of browserProviderCallsAllowed returned in the response body.
externalApiCallsAllowedbooleanRequiredValue of externalApiCallsAllowed returned in the response body.
staticOnlyHostingAllowedbooleanRequiredValue of staticOnlyHostingAllowed returned in the response body.
roleBypassAllowedbooleanRequiredValue of roleBypassAllowed returned in the response body.
unsafeAdminDetailAllowedbooleanRequiredValue of unsafeAdminDetailAllowed returned in the response body.
rawSearchRowsAllowedbooleanRequiredValue of rawSearchRowsAllowed returned in the response body.
rawEvidencePayloadsAllowedbooleanRequiredValue of rawEvidencePayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
accessTokenValuesAllowedbooleanRequiredValue of accessTokenValuesAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
architectureSurfacesarray<JSON value>RequiredValue of architectureSurfaces returned in the response body.
primaryNavigationarray<JSON value>RequiredValue of primaryNavigation returned in the response body.
personaViewsarray<JSON value>RequiredValue of personaViews returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/portal-information-architecture-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "architectureMode": "<string>",
  "portalRuntime": "<string>",
  "browserIsolationRequired": false,
  "stableNavigationRequired": false,
  "sameOriginApiRoutingRequired": false,
  "ssrRequired": false,
  "hydrationRequired": false,
  "serverFunctionBoundaryRequired": false,
  "browserProviderCallsAllowed": false,
  "externalApiCallsAllowed": false,
  "staticOnlyHostingAllowed": false,
  "roleBypassAllowed": false,
  "unsafeAdminDetailAllowed": false,
  "rawSearchRowsAllowed": false,
  "rawEvidencePayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "credentialValuesAllowed": false,
  "secretValuesAllowed": false,
  "accessTokenValuesAllowed": false,
  "rawRecipientDataAllowed": false,
  "architectureSurfaces": [],
  "primaryNavigation": [],
  "personaViews": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/registry-readiness-contract

request access

Platform registry readiness.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/registry-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
registryProviderstringRequiredValue of registryProvider returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
harborApiCallsAllowedbooleanRequiredValue of harborApiCallsAllowed returned in the response body.
registryPushAllowedbooleanRequiredValue of registryPushAllowed returned in the response body.
registryPullAllowedbooleanRequiredValue of registryPullAllowed returned in the response body.
projectMutationAllowedbooleanRequiredValue of projectMutationAllowed returned in the response body.
robotAccountMutationAllowedbooleanRequiredValue of robotAccountMutationAllowed returned in the response body.
retentionPolicyMutationAllowedbooleanRequiredValue of retentionPolicyMutationAllowed returned in the response body.
immutabilityRuleMutationAllowedbooleanRequiredValue of immutabilityRuleMutationAllowed returned in the response body.
scannerMutationAllowedbooleanRequiredValue of scannerMutationAllowed returned in the response body.
replicationMutationAllowedbooleanRequiredValue of replicationMutationAllowed returned in the response body.
webhookMutationAllowedbooleanRequiredValue of webhookMutationAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
robotSecretValuesAllowedbooleanRequiredValue of robotSecretValuesAllowed returned in the response body.
registryUrlsAllowedbooleanRequiredValue of registryUrlsAllowed returned in the response body.
imageDigestsAllowedbooleanRequiredValue of imageDigestsAllowed returned in the response body.
rawRegistryPayloadsAllowedbooleanRequiredValue of rawRegistryPayloadsAllowed returned in the response body.
rawScannerPayloadsAllowedbooleanRequiredValue of rawScannerPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
registryIdentifiersAllowedbooleanRequiredValue of registryIdentifiersAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/registry-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "registryProvider": "<string>",
  "providerCallsEnabled": false,
  "harborApiCallsAllowed": false,
  "registryPushAllowed": false,
  "registryPullAllowed": false,
  "projectMutationAllowed": false,
  "robotAccountMutationAllowed": false,
  "retentionPolicyMutationAllowed": false,
  "immutabilityRuleMutationAllowed": false,
  "scannerMutationAllowed": false,
  "replicationMutationAllowed": false,
  "webhookMutationAllowed": false,
  "credentialValuesAllowed": false,
  "robotSecretValuesAllowed": false,
  "registryUrlsAllowed": false,
  "imageDigestsAllowed": false,
  "rawRegistryPayloadsAllowed": false,
  "rawScannerPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "registryIdentifiersAllowed": false,
  "readinessSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/release-promotion-contract

request access

Platform release promotion.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/release-promotion-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
promotionModestringRequiredValue of promotionMode returned in the response body.
dryRunRequiredbooleanRequiredValue of dryRunRequired returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
liveDeploymentAllowedbooleanRequiredValue of liveDeploymentAllowed returned in the response body.
registryPushAllowedbooleanRequiredValue of registryPushAllowed returned in the response body.
helmUpgradeAllowedbooleanRequiredValue of helmUpgradeAllowed returned in the response body.
kubectlApplyAllowedbooleanRequiredValue of kubectlApplyAllowed returned in the response body.
clusterMutationAllowedbooleanRequiredValue of clusterMutationAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
rawPipelineLogsAllowedbooleanRequiredValue of rawPipelineLogsAllowed returned in the response body.
rawRegistryPayloadsAllowedbooleanRequiredValue of rawRegistryPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
promotionStagesarray<JSON value>RequiredValue of promotionStages returned in the response body.
validationSignalsarray<JSON value>RequiredValue of validationSignals returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/release-promotion-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "promotionMode": "<string>",
  "dryRunRequired": false,
  "providerCallsEnabled": false,
  "liveDeploymentAllowed": false,
  "registryPushAllowed": false,
  "helmUpgradeAllowed": false,
  "kubectlApplyAllowed": false,
  "clusterMutationAllowed": false,
  "credentialValuesAllowed": false,
  "rawPipelineLogsAllowed": false,
  "rawRegistryPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "promotionStages": [],
  "validationSignals": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/security-baseline-contract

request access

Platform security baseline.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/security-baseline-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
baselineModestringRequiredValue of baselineMode returned in the response body.
noSecretPolicyRequiredbooleanRequiredValue of noSecretPolicyRequired returned in the response body.
browserIsolationRequiredbooleanRequiredValue of browserIsolationRequired returned in the response body.
networkIsolationRequiredbooleanRequiredValue of networkIsolationRequired returned in the response body.
rbacApprovalRequiredbooleanRequiredValue of rbacApprovalRequired returned in the response body.
dryRunRequiredbooleanRequiredValue of dryRunRequired returned in the response body.
redactedEvidenceRequiredbooleanRequiredValue of redactedEvidenceRequired returned in the response body.
verificationGatesRequiredbooleanRequiredValue of verificationGatesRequired returned in the response body.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
liveAuthenticationAllowedbooleanRequiredValue of liveAuthenticationAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
policyMutationAllowedbooleanRequiredValue of policyMutationAllowed returned in the response body.
approvalBypassAllowedbooleanRequiredValue of approvalBypassAllowed returned in the response body.
rbacBypassAllowedbooleanRequiredValue of rbacBypassAllowed returned in the response body.
browserVendorEndpointAllowedbooleanRequiredValue of browserVendorEndpointAllowed returned in the response body.
rawRequestPayloadsAllowedbooleanRequiredValue of rawRequestPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawEvidencePayloadsAllowedbooleanRequiredValue of rawEvidencePayloadsAllowed returned in the response body.
rawLogContentAllowedbooleanRequiredValue of rawLogContentAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
accessTokenValuesAllowedbooleanRequiredValue of accessTokenValuesAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
securityControlsarray<JSON value>RequiredValue of securityControls returned in the response body.
verificationGatesarray<JSON value>RequiredValue of verificationGates returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/security-baseline-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "baselineMode": "<string>",
  "noSecretPolicyRequired": false,
  "browserIsolationRequired": false,
  "networkIsolationRequired": false,
  "rbacApprovalRequired": false,
  "dryRunRequired": false,
  "redactedEvidenceRequired": false,
  "verificationGatesRequired": false,
  "providerCallsAllowed": false,
  "liveAuthenticationAllowed": false,
  "workflowMutationAllowed": false,
  "policyMutationAllowed": false,
  "approvalBypassAllowed": false,
  "rbacBypassAllowed": false,
  "browserVendorEndpointAllowed": false,
  "rawRequestPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "rawEvidencePayloadsAllowed": false,
  "rawLogContentAllowed": false,
  "credentialValuesAllowed": false,
  "secretValuesAllowed": false,
  "accessTokenValuesAllowed": false,
  "rawRecipientDataAllowed": false,
  "securityControls": [],
  "verificationGates": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/status

audit access

Platform status.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/status

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

For 200, the known response body type is serde_json::Value. Its field schema is unavailable, so no JSON shape is inferred.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/status'

GET/api/platform/status-contract

request access

Platform status contract.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/status-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
modestringRequiredValue of mode returned in the response body.
statusstringRequiredCurrent operation or resource status.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
liveExecutionAllowedbooleanRequiredValue of liveExecutionAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
guardsJSON valueRequiredValue of guards returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/status-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "mode": "<string>",
  "status": "<string>",
  "providerCallsAllowed": false,
  "liveExecutionAllowed": false,
  "workflowMutationAllowed": false,
  "credentialValuesAllowed": false,
  "secretValuesAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "rawRecipientDataAllowed": false,
  "tenantIdentifiersAllowed": false,
  "objectIdentifiersAllowed": false,
  "privateNetworkValuesAllowed": false,
  "guards": null,
  "blockedReasons": []
}

GET/api/platform/summary

public accessno bearer auth required

Platform summary.

Permissions

Access classCredentialScoping
publicNo user or agent bearer token is required. Operation-specific proof, when present, is documented below.No authenticated-principal scope is applied to this operation.

HTTP request

GET https://<your-host>/api/platform/summary

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
productNameJSON valueRequiredValue of productName returned in the response body.
lifecycleStagesJSON valueRequiredValue of lifecycleStages returned in the response body.
componentsJSON valueRequiredValue of components returned in the response body.
guardrailsJSON valueRequiredValue of guardrails returned in the response body.
browserIsolationbooleanRequiredValue of browserIsolation returned in the response body.
localAuthorizationJSON valueRequiredValue of localAuthorization returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  'https://<your-host>/api/platform/summary'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "productName": null,
  "lifecycleStages": null,
  "components": null,
  "guardrails": null,
  "browserIsolation": false,
  "localAuthorization": null
}

GET/api/platform/ui-mockup-acceptance-contract

request access

Platform ui mockup.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/ui-mockup-acceptance-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
acceptanceModestringRequiredValue of acceptanceMode returned in the response body.
mockupCoverageRequiredbooleanRequiredValue of mockupCoverageRequired returned in the response body.
accessibilityReviewRequiredbooleanRequiredValue of accessibilityReviewRequired returned in the response body.
browserIsolationRequiredbooleanRequiredValue of browserIsolationRequired returned in the response body.
evidenceSafetyRequiredbooleanRequiredValue of evidenceSafetyRequired returned in the response body.
liveUiExecutionAllowedbooleanRequiredValue of liveUiExecutionAllowed returned in the response body.
browserProviderCallsAllowedbooleanRequiredValue of browserProviderCallsAllowed returned in the response body.
externalAssetFetchAllowedbooleanRequiredValue of externalAssetFetchAllowed returned in the response body.
directVendorApiAllowedbooleanRequiredValue of directVendorApiAllowed returned in the response body.
unsafeDebugDetailAllowedbooleanRequiredValue of unsafeDebugDetailAllowed returned in the response body.
rawMockupRowsAllowedbooleanRequiredValue of rawMockupRowsAllowed returned in the response body.
rawEvidencePayloadsAllowedbooleanRequiredValue of rawEvidencePayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
accessTokenValuesAllowedbooleanRequiredValue of accessTokenValuesAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
mockupDocumentsarray<JSON value>RequiredValue of mockupDocuments returned in the response body.
mockupSurfacesarray<JSON value>RequiredValue of mockupSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/ui-mockup-acceptance-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "acceptanceMode": "<string>",
  "mockupCoverageRequired": false,
  "accessibilityReviewRequired": false,
  "browserIsolationRequired": false,
  "evidenceSafetyRequired": false,
  "liveUiExecutionAllowed": false,
  "browserProviderCallsAllowed": false,
  "externalAssetFetchAllowed": false,
  "directVendorApiAllowed": false,
  "unsafeDebugDetailAllowed": false,
  "rawMockupRowsAllowed": false,
  "rawEvidencePayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "credentialValuesAllowed": false,
  "secretValuesAllowed": false,
  "accessTokenValuesAllowed": false,
  "rawRecipientDataAllowed": false,
  "mockupDocuments": [],
  "mockupSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/uptime

audit access

Uptime.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/uptime

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

200 response body

Structure: serde_json::Value.

NameTypeRequirementDescription
uptime_secondsJSON valueRequiredValue of uptime_seconds returned in the response body.
uptime_humanJSON valueRequiredValue of uptime_human returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/uptime'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "uptime_seconds": null,
  "uptime_human": null
}

GET/api/platform/vault-deployment-readiness-contract

request access

Platform vault deployment.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/vault-deployment-readiness-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
vaultProviderstringRequiredValue of vaultProvider returned in the response body.
deploymentTargetstringRequiredValue of deploymentTarget returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
vaultApiCallsAllowedbooleanRequiredValue of vaultApiCallsAllowed returned in the response body.
helmInstallAllowedbooleanRequiredValue of helmInstallAllowed returned in the response body.
helmUpgradeAllowedbooleanRequiredValue of helmUpgradeAllowed returned in the response body.
kubectlApplyAllowedbooleanRequiredValue of kubectlApplyAllowed returned in the response body.
vaultInitAllowedbooleanRequiredValue of vaultInitAllowed returned in the response body.
vaultUnsealAllowedbooleanRequiredValue of vaultUnsealAllowed returned in the response body.
vaultPolicyMutationAllowedbooleanRequiredValue of vaultPolicyMutationAllowed returned in the response body.
kubernetesAuthMutationAllowedbooleanRequiredValue of kubernetesAuthMutationAllowed returned in the response body.
secretWriteAllowedbooleanRequiredValue of secretWriteAllowed returned in the response body.
injectorMutationAllowedbooleanRequiredValue of injectorMutationAllowed returned in the response body.
autoUnsealMutationAllowedbooleanRequiredValue of autoUnsealMutationAllowed returned in the response body.
auditLogReadAllowedbooleanRequiredValue of auditLogReadAllowed returned in the response body.
rawVaultPayloadsAllowedbooleanRequiredValue of rawVaultPayloadsAllowed returned in the response body.
rawKubernetesPayloadsAllowedbooleanRequiredValue of rawKubernetesPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
vaultIdentifiersAllowedbooleanRequiredValue of vaultIdentifiersAllowed returned in the response body.
readinessSurfacesarray<JSON value>RequiredValue of readinessSurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/vault-deployment-readiness-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "vaultProvider": "<string>",
  "deploymentTarget": "<string>",
  "providerCallsEnabled": false,
  "vaultApiCallsAllowed": false,
  "helmInstallAllowed": false,
  "helmUpgradeAllowed": false,
  "kubectlApplyAllowed": false,
  "vaultInitAllowed": false,
  "vaultUnsealAllowed": false,
  "vaultPolicyMutationAllowed": false,
  "kubernetesAuthMutationAllowed": false,
  "secretWriteAllowed": false,
  "injectorMutationAllowed": false,
  "autoUnsealMutationAllowed": false,
  "auditLogReadAllowed": false,
  "rawVaultPayloadsAllowed": false,
  "rawKubernetesPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "secretValuesAllowed": false,
  "vaultIdentifiersAllowed": false,
  "readinessSurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/api/platform/vault-secret-delivery-contract

request access

Platform vault secret delivery.

Permissions

Access classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/platform/vault-secret-delivery-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
readinessModestringRequiredValue of readinessMode returned in the response body.
deliveryProviderstringRequiredValue of deliveryProvider returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
vaultApiCallsAllowedbooleanRequiredValue of vaultApiCallsAllowed returned in the response body.
kubernetesApplyAllowedbooleanRequiredValue of kubernetesApplyAllowed returned in the response body.
helmInstallAllowedbooleanRequiredValue of helmInstallAllowed returned in the response body.
helmUpgradeAllowedbooleanRequiredValue of helmUpgradeAllowed returned in the response body.
crdApplyAllowedbooleanRequiredValue of crdApplyAllowed returned in the response body.
vaultConnectionMutationAllowedbooleanRequiredValue of vaultConnectionMutationAllowed returned in the response body.
vaultAuthMutationAllowedbooleanRequiredValue of vaultAuthMutationAllowed returned in the response body.
vaultStaticSecretMutationAllowedbooleanRequiredValue of vaultStaticSecretMutationAllowed returned in the response body.
kubernetesSecretMutationAllowedbooleanRequiredValue of kubernetesSecretMutationAllowed returned in the response body.
secretDataReadAllowedbooleanRequiredValue of secretDataReadAllowed returned in the response body.
secretDataWriteAllowedbooleanRequiredValue of secretDataWriteAllowed returned in the response body.
rolloutRestartAllowedbooleanRequiredValue of rolloutRestartAllowed returned in the response body.
transformationTemplateAllowedbooleanRequiredValue of transformationTemplateAllowed returned in the response body.
rawVaultPayloadsAllowedbooleanRequiredValue of rawVaultPayloadsAllowed returned in the response body.
rawKubernetesPayloadsAllowedbooleanRequiredValue of rawKubernetesPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
vaultIdentifiersAllowedbooleanRequiredValue of vaultIdentifiersAllowed returned in the response body.
deliverySurfacesarray<JSON value>RequiredValue of deliverySurfaces returned in the response body.
requiredInputsarray<JSON value>RequiredValue of requiredInputs returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
planSectionsarray<JSON value>RequiredValue of planSections returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/platform/vault-secret-delivery-contract'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "source": "<string>",
  "readinessMode": "<string>",
  "deliveryProvider": "<string>",
  "providerCallsEnabled": false,
  "vaultApiCallsAllowed": false,
  "kubernetesApplyAllowed": false,
  "helmInstallAllowed": false,
  "helmUpgradeAllowed": false,
  "crdApplyAllowed": false,
  "vaultConnectionMutationAllowed": false,
  "vaultAuthMutationAllowed": false,
  "vaultStaticSecretMutationAllowed": false,
  "kubernetesSecretMutationAllowed": false,
  "secretDataReadAllowed": false,
  "secretDataWriteAllowed": false,
  "rolloutRestartAllowed": false,
  "transformationTemplateAllowed": false,
  "rawVaultPayloadsAllowed": false,
  "rawKubernetesPayloadsAllowed": false,
  "rawProviderPayloadsAllowed": false,
  "secretValuesAllowed": false,
  "vaultIdentifiersAllowed": false,
  "deliverySurfaces": [],
  "requiredInputs": [],
  "requiredGuards": [],
  "planSections": [],
  "blockedReasons": [],
  "requiredEvidence": [],
  "rules": []
}

GET/health

public accessno bearer auth required

Health.

Permissions

Access classCredentialScoping
publicNo user or agent bearer token is required. Operation-specific proof, when present, is documented below.No authenticated-principal scope is applied to this operation.

HTTP request

GET https://<your-host>/health

Path parameters

This operation has no path parameters.

Query parameters

NameTypeRequirementDescription
simulatestringOptionalSet to error to exercise the documented 503 probe response.

Request headers

NameTypeRequirementDescription
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

200 response body

Structure: serde_json::Value.

NameTypeRequirementDescription
statusJSON valueRequiredCurrent operation or resource status.
databaseJSON valueRequiredValue of database returned in the response body.
configJSON valueRequiredValue of config returned in the response body.
auth_modeJSON valueRequiredValue of auth_mode returned in the response body.
rate_limit_enabledJSON valueRequiredValue of rate_limit_enabled returned in the response body.

Error responses use the platform ApiError body (error, message, optional detail).

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  'https://<your-host>/health'

Schematic response body

Illustrative shape generated from the extracted field types, not a recorded live response. Values are placeholders; null marks a field whose type could not be resolved.

Success status: 200

{
  "status": null,
  "database": null,
  "config": null,
  "auth_mode": null,
  "rate_limit_enabled": null
}

GET/metrics

audit access

Metrics.

Permissions

Access classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/metrics

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

NameTypeRequirementDescription
AuthorizationstringOptionalHuman credential alternative: supply one Bearer rys_... session token, ryk_... API token, or validated identity-provider JWT here. Do not combine it with X-Ryuki-Session-Id or the session cookie; conflicting carriers fail closed.
X-Ryuki-Session-IdstringOptionalOpaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request.
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKRaw or text response body

For 200, the operation returns a raw or text response body; no JSON shape applies.

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/metrics'

GET/ready

public accessno bearer auth required

Ready.

Permissions

Access classCredentialScoping
publicNo user or agent bearer token is required. Operation-specific proof, when present, is documented below.No authenticated-principal scope is applied to this operation.

HTTP request

GET https://<your-host>/ready

Path parameters

This operation has no path parameters.

Query parameters

NameTypeRequirementDescription
simulatestringOptionalSet to error to exercise the documented 503 probe response.

Request headers

NameTypeRequirementDescription
traceparentstringOptionalOptional correlation input. When the second dash-separated segment has 32 characters, Ryuki reuses it as the request correlation identifier; this is not full W3C validation.

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKserde_json::Value

For 200, the known response body type is serde_json::Value. Its field schema is unavailable, so no JSON shape is inferred.

Error responses use the platform ApiError body (error, message, optional detail).

Errors

JSON failures use one of the platform error envelopes and include the request correlation metadata when routing reaches the API middleware. See Errors for the exact shapes, authentication failures, retry guidance, and transport-level exceptions.

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  'https://<your-host>/ready'
Last updated 2026-07-16 · Generated from the API route registrations.