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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
databaseProvider | string | Required | Value of databaseProvider returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
kubernetesApplyAllowed | boolean | Required | Value of kubernetesApplyAllowed returned in the response body. |
cnpgClusterCreationAllowed | boolean | Required | Value of cnpgClusterCreationAllowed returned in the response body. |
databaseMutationAllowed | boolean | Required | Value of databaseMutationAllowed returned in the response body. |
schemaMigrationAllowed | boolean | Required | Value of schemaMigrationAllowed returned in the response body. |
backupExecutionAllowed | boolean | Required | Value of backupExecutionAllowed returned in the response body. |
restoreExecutionAllowed | boolean | Required | Value of restoreExecutionAllowed returned in the response body. |
objectStorageAccessAllowed | boolean | Required | Value of objectStorageAccessAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
connectionStringsAllowed | boolean | Required | Value of connectionStringsAllowed returned in the response body. |
rawDatabaseRowsAllowed | boolean | Required | Value of rawDatabaseRowsAllowed returned in the response body. |
rawBackupPayloadsAllowed | boolean | Required | Value of rawBackupPayloadsAllowed returned in the response body. |
rawKubernetesPayloadsAllowed | boolean | Required | Value of rawKubernetesPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
admin | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
site | string | Required | Value of the site request-path segment. |
Query parameters
This operation has no query parameters.
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
Idempotency-Key | string | Optional | Optional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
admin | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
site | string | Required | Value of the site request-path segment. |
Query parameters
This operation has no query parameters.
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Type | string | Required | Required by the resolved Axum Json<T> request extractor; send application/json. |
X-Ryuki-Session-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
Idempotency-Key | string | Optional | Optional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication. |
traceparent | string | Optional | Optional 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.
| Name | Type | Requirement | Description |
|---|---|---|---|
reason | string | Required | Human-readable reason recorded with the operation and its audit trail. |
Response
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
admin | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
site | string | Required | Value of the site request-path segment. |
Query parameters
This operation has no query parameters.
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
Idempotency-Key | string | Optional | Optional at-most-once retry key for human mutations. When omitted, the idempotency middleware passes the request through without deduplication. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
designMode | string | Required | Value of designMode returned in the response body. |
lightModeRequired | boolean | Required | Value of lightModeRequired returned in the response body. |
darkModeRequired | boolean | Required | Value of darkModeRequired returned in the response body. |
accessibilityReviewRequired | boolean | Required | Value of accessibilityReviewRequired returned in the response body. |
evidenceSafetyRequired | boolean | Required | Value of evidenceSafetyRequired returned in the response body. |
liveThemeMutationAllowed | boolean | Required | Value of liveThemeMutationAllowed returned in the response body. |
externalFontFetchAllowed | boolean | Required | Value of externalFontFetchAllowed returned in the response body. |
unsafeErrorDetailAllowed | boolean | Required | Value of unsafeErrorDetailAllowed returned in the response body. |
rawUiDiagnosticRowsAllowed | boolean | Required | Value of rawUiDiagnosticRowsAllowed returned in the response body. |
rawEvidencePayloadsAllowed | boolean | Required | Value of rawEvidencePayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
accessTokenValuesAllowed | boolean | Required | Value of accessTokenValuesAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
brandTokens | array<JSON value> | Required | Value of brandTokens returned in the response body. |
designSurfaces | array<JSON value> | Required | Value of designSurfaces returned in the response body. |
statusFamilies | array<JSON value> | Required | Value of statusFamilies returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
adapters | JSON value | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
adapter | string | Required | Value of the adapter request-path segment. |
Query parameters
This operation has no query parameters.
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | ryuki_engine::health_monitor::HealthCheck |
200 response body
Structure: ryuki_engine::health_monitor::HealthCheck.
| Name | Type | Requirement | Description |
|---|---|---|---|
name | string | Required | Value of name returned in the response body. |
component | string | Required | Value of component returned in the response body. |
status | object (HealthStatus) | Required | Current operation or resource status. |
source | object (HealthSource) | Required | Origin or authority of the returned data. |
last_check | string | Required | Value of last_check returned in the response body. |
message | string | Required | Human-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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | JSON value | Required | Origin or authority of the returned data. |
overall_status | JSON value | Required | Value of overall_status returned in the response body. |
timestamp | JSON value | Required | Value of timestamp returned in the response body. |
components | JSON value | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Raw 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
runtimeProvider | string | Required | Value of runtimeProvider returned in the response body. |
deploymentTarget | string | Required | Value of deploymentTarget returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
kubectlApplyAllowed | boolean | Required | Value of kubectlApplyAllowed returned in the response body. |
helmInstallAllowed | boolean | Required | Value of helmInstallAllowed returned in the response body. |
helmUpgradeAllowed | boolean | Required | Value of helmUpgradeAllowed returned in the response body. |
kustomizeBuildAllowed | boolean | Required | Value of kustomizeBuildAllowed returned in the response body. |
clusterMutationAllowed | boolean | Required | Value of clusterMutationAllowed returned in the response body. |
namespaceMutationAllowed | boolean | Required | Value of namespaceMutationAllowed returned in the response body. |
deploymentMutationAllowed | boolean | Required | Value of deploymentMutationAllowed returned in the response body. |
serviceMutationAllowed | boolean | Required | Value of serviceMutationAllowed returned in the response body. |
ingressMutationAllowed | boolean | Required | Value of ingressMutationAllowed returned in the response body. |
networkPolicyMutationAllowed | boolean | Required | Value of networkPolicyMutationAllowed returned in the response body. |
serviceAccountMutationAllowed | boolean | Required | Value of serviceAccountMutationAllowed returned in the response body. |
sensitiveResourceMutationAllowed | boolean | Required | Value of sensitiveResourceMutationAllowed returned in the response body. |
imagePullAllowed | boolean | Required | Value of imagePullAllowed returned in the response body. |
registryAccessAllowed | boolean | Required | Value of registryAccessAllowed returned in the response body. |
rawKubernetesPayloadsAllowed | boolean | Required | Value of rawKubernetesPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
kubeconfigValuesAllowed | boolean | Required | Value of kubeconfigValuesAllowed returned in the response body. |
clusterIdentifiersAllowed | boolean | Required | Value of clusterIdentifiersAllowed returned in the response body. |
sensitiveValuesAllowed | boolean | Required | Value of sensitiveValuesAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
ingressFrontTierProfiles | array<JSON value> | Required | Value of ingressFrontTierProfiles returned in the response body. |
ingressRoutePostures | array<JSON value> | Required | Value of ingressRoutePostures returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
runtimeProvider | string | Required | Value of runtimeProvider returned in the response body. |
deploymentTarget | string | Required | Value of deploymentTarget returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
dockerComposeUpAllowed | boolean | Required | Value of dockerComposeUpAllowed returned in the response body. |
dockerComposeBuildAllowed | boolean | Required | Value of dockerComposeBuildAllowed returned in the response body. |
dockerRunAllowed | boolean | Required | Value of dockerRunAllowed returned in the response body. |
imagePushAllowed | boolean | Required | Value of imagePushAllowed returned in the response body. |
registryAccessAllowed | boolean | Required | Value of registryAccessAllowed returned in the response body. |
serviceMutationAllowed | boolean | Required | Value of serviceMutationAllowed returned in the response body. |
networkMutationAllowed | boolean | Required | Value of networkMutationAllowed returned in the response body. |
portBindingMutationAllowed | boolean | Required | Value of portBindingMutationAllowed returned in the response body. |
environmentValuesAllowed | boolean | Required | Value of environmentValuesAllowed returned in the response body. |
envFileAllowed | boolean | Required | Value of envFileAllowed returned in the response body. |
volumeMountsAllowed | boolean | Required | Value of volumeMountsAllowed returned in the response body. |
providerServiceAllowed | boolean | Required | Value of providerServiceAllowed returned in the response body. |
externalEgressAllowed | boolean | Required | Value of externalEgressAllowed returned in the response body. |
rawRuntimePayloadsAllowed | boolean | Required | Value of rawRuntimePayloadsAllowed returned in the response body. |
providerReturnedContentAllowed | boolean | Required | Value of providerReturnedContentAllowed returned in the response body. |
sensitiveAuthValuesAllowed | boolean | Required | Value of sensitiveAuthValuesAllowed returned in the response body. |
runtimeIdentifiersAllowed | boolean | Required | Value of runtimeIdentifiersAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
storageProvider | string | Required | Value of storageProvider returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
azureApiCallsAllowed | boolean | Required | Value of azureApiCallsAllowed returned in the response body. |
storageAccountMutationAllowed | boolean | Required | Value of storageAccountMutationAllowed returned in the response body. |
containerMutationAllowed | boolean | Required | Value of containerMutationAllowed returned in the response body. |
blobReadWriteAllowed | boolean | Required | Value of blobReadWriteAllowed returned in the response body. |
lifecyclePolicyMutationAllowed | boolean | Required | Value of lifecyclePolicyMutationAllowed returned in the response body. |
immutabilityPolicyMutationAllowed | boolean | Required | Value of immutabilityPolicyMutationAllowed returned in the response body. |
publicNetworkAccessAllowed | boolean | Required | Value of publicNetworkAccessAllowed returned in the response body. |
sharedKeyUsageAllowed | boolean | Required | Value of sharedKeyUsageAllowed returned in the response body. |
sasTokenValuesAllowed | boolean | Required | Value of sasTokenValuesAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
connectionStringsAllowed | boolean | Required | Value of connectionStringsAllowed returned in the response body. |
rawBlobPayloadsAllowed | boolean | Required | Value of rawBlobPayloadsAllowed returned in the response body. |
rawStoragePayloadsAllowed | boolean | Required | Value of rawStoragePayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
storageIdentifiersAllowed | boolean | Required | Value of storageIdentifiersAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
architectureMode | string | Required | Value of architectureMode returned in the response body. |
portalRuntime | string | Required | Value of portalRuntime returned in the response body. |
browserIsolationRequired | boolean | Required | Value of browserIsolationRequired returned in the response body. |
stableNavigationRequired | boolean | Required | Value of stableNavigationRequired returned in the response body. |
sameOriginApiRoutingRequired | boolean | Required | Value of sameOriginApiRoutingRequired returned in the response body. |
ssrRequired | boolean | Required | Value of ssrRequired returned in the response body. |
hydrationRequired | boolean | Required | Value of hydrationRequired returned in the response body. |
serverFunctionBoundaryRequired | boolean | Required | Value of serverFunctionBoundaryRequired returned in the response body. |
browserProviderCallsAllowed | boolean | Required | Value of browserProviderCallsAllowed returned in the response body. |
externalApiCallsAllowed | boolean | Required | Value of externalApiCallsAllowed returned in the response body. |
staticOnlyHostingAllowed | boolean | Required | Value of staticOnlyHostingAllowed returned in the response body. |
roleBypassAllowed | boolean | Required | Value of roleBypassAllowed returned in the response body. |
unsafeAdminDetailAllowed | boolean | Required | Value of unsafeAdminDetailAllowed returned in the response body. |
rawSearchRowsAllowed | boolean | Required | Value of rawSearchRowsAllowed returned in the response body. |
rawEvidencePayloadsAllowed | boolean | Required | Value of rawEvidencePayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
accessTokenValuesAllowed | boolean | Required | Value of accessTokenValuesAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
architectureSurfaces | array<JSON value> | Required | Value of architectureSurfaces returned in the response body. |
primaryNavigation | array<JSON value> | Required | Value of primaryNavigation returned in the response body. |
personaViews | array<JSON value> | Required | Value of personaViews returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
registryProvider | string | Required | Value of registryProvider returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
harborApiCallsAllowed | boolean | Required | Value of harborApiCallsAllowed returned in the response body. |
registryPushAllowed | boolean | Required | Value of registryPushAllowed returned in the response body. |
registryPullAllowed | boolean | Required | Value of registryPullAllowed returned in the response body. |
projectMutationAllowed | boolean | Required | Value of projectMutationAllowed returned in the response body. |
robotAccountMutationAllowed | boolean | Required | Value of robotAccountMutationAllowed returned in the response body. |
retentionPolicyMutationAllowed | boolean | Required | Value of retentionPolicyMutationAllowed returned in the response body. |
immutabilityRuleMutationAllowed | boolean | Required | Value of immutabilityRuleMutationAllowed returned in the response body. |
scannerMutationAllowed | boolean | Required | Value of scannerMutationAllowed returned in the response body. |
replicationMutationAllowed | boolean | Required | Value of replicationMutationAllowed returned in the response body. |
webhookMutationAllowed | boolean | Required | Value of webhookMutationAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
robotSecretValuesAllowed | boolean | Required | Value of robotSecretValuesAllowed returned in the response body. |
registryUrlsAllowed | boolean | Required | Value of registryUrlsAllowed returned in the response body. |
imageDigestsAllowed | boolean | Required | Value of imageDigestsAllowed returned in the response body. |
rawRegistryPayloadsAllowed | boolean | Required | Value of rawRegistryPayloadsAllowed returned in the response body. |
rawScannerPayloadsAllowed | boolean | Required | Value of rawScannerPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
registryIdentifiersAllowed | boolean | Required | Value of registryIdentifiersAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
promotionMode | string | Required | Value of promotionMode returned in the response body. |
dryRunRequired | boolean | Required | Value of dryRunRequired returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
liveDeploymentAllowed | boolean | Required | Value of liveDeploymentAllowed returned in the response body. |
registryPushAllowed | boolean | Required | Value of registryPushAllowed returned in the response body. |
helmUpgradeAllowed | boolean | Required | Value of helmUpgradeAllowed returned in the response body. |
kubectlApplyAllowed | boolean | Required | Value of kubectlApplyAllowed returned in the response body. |
clusterMutationAllowed | boolean | Required | Value of clusterMutationAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
rawPipelineLogsAllowed | boolean | Required | Value of rawPipelineLogsAllowed returned in the response body. |
rawRegistryPayloadsAllowed | boolean | Required | Value of rawRegistryPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
promotionStages | array<JSON value> | Required | Value of promotionStages returned in the response body. |
validationSignals | array<JSON value> | Required | Value of validationSignals returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
baselineMode | string | Required | Value of baselineMode returned in the response body. |
noSecretPolicyRequired | boolean | Required | Value of noSecretPolicyRequired returned in the response body. |
browserIsolationRequired | boolean | Required | Value of browserIsolationRequired returned in the response body. |
networkIsolationRequired | boolean | Required | Value of networkIsolationRequired returned in the response body. |
rbacApprovalRequired | boolean | Required | Value of rbacApprovalRequired returned in the response body. |
dryRunRequired | boolean | Required | Value of dryRunRequired returned in the response body. |
redactedEvidenceRequired | boolean | Required | Value of redactedEvidenceRequired returned in the response body. |
verificationGatesRequired | boolean | Required | Value of verificationGatesRequired returned in the response body. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
liveAuthenticationAllowed | boolean | Required | Value of liveAuthenticationAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
policyMutationAllowed | boolean | Required | Value of policyMutationAllowed returned in the response body. |
approvalBypassAllowed | boolean | Required | Value of approvalBypassAllowed returned in the response body. |
rbacBypassAllowed | boolean | Required | Value of rbacBypassAllowed returned in the response body. |
browserVendorEndpointAllowed | boolean | Required | Value of browserVendorEndpointAllowed returned in the response body. |
rawRequestPayloadsAllowed | boolean | Required | Value of rawRequestPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
rawEvidencePayloadsAllowed | boolean | Required | Value of rawEvidencePayloadsAllowed returned in the response body. |
rawLogContentAllowed | boolean | Required | Value of rawLogContentAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
accessTokenValuesAllowed | boolean | Required | Value of accessTokenValuesAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
securityControls | array<JSON value> | Required | Value of securityControls returned in the response body. |
verificationGates | array<JSON value> | Required | Value of verificationGates returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
mode | string | Required | Value of mode returned in the response body. |
status | string | Required | Current operation or resource status. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
liveExecutionAllowed | boolean | Required | Value of liveExecutionAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
tenantIdentifiersAllowed | boolean | Required | Value of tenantIdentifiersAllowed returned in the response body. |
objectIdentifiersAllowed | boolean | Required | Value of objectIdentifiersAllowed returned in the response body. |
privateNetworkValuesAllowed | boolean | Required | Value of privateNetworkValuesAllowed returned in the response body. |
guards | JSON value | Required | Value of guards returned in the response body. |
blockedReasons | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
public | No 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
| Name | Type | Requirement | Description |
|---|---|---|---|
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
productName | JSON value | Required | Value of productName returned in the response body. |
lifecycleStages | JSON value | Required | Value of lifecycleStages returned in the response body. |
components | JSON value | Required | Value of components returned in the response body. |
guardrails | JSON value | Required | Value of guardrails returned in the response body. |
browserIsolation | boolean | Required | Value of browserIsolation returned in the response body. |
localAuthorization | JSON value | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
acceptanceMode | string | Required | Value of acceptanceMode returned in the response body. |
mockupCoverageRequired | boolean | Required | Value of mockupCoverageRequired returned in the response body. |
accessibilityReviewRequired | boolean | Required | Value of accessibilityReviewRequired returned in the response body. |
browserIsolationRequired | boolean | Required | Value of browserIsolationRequired returned in the response body. |
evidenceSafetyRequired | boolean | Required | Value of evidenceSafetyRequired returned in the response body. |
liveUiExecutionAllowed | boolean | Required | Value of liveUiExecutionAllowed returned in the response body. |
browserProviderCallsAllowed | boolean | Required | Value of browserProviderCallsAllowed returned in the response body. |
externalAssetFetchAllowed | boolean | Required | Value of externalAssetFetchAllowed returned in the response body. |
directVendorApiAllowed | boolean | Required | Value of directVendorApiAllowed returned in the response body. |
unsafeDebugDetailAllowed | boolean | Required | Value of unsafeDebugDetailAllowed returned in the response body. |
rawMockupRowsAllowed | boolean | Required | Value of rawMockupRowsAllowed returned in the response body. |
rawEvidencePayloadsAllowed | boolean | Required | Value of rawEvidencePayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
accessTokenValuesAllowed | boolean | Required | Value of accessTokenValuesAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
mockupDocuments | array<JSON value> | Required | Value of mockupDocuments returned in the response body. |
mockupSurfaces | array<JSON value> | Required | Value of mockupSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_json::Value |
200 response body
Structure: serde_json::Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
uptime_seconds | JSON value | Required | Value of uptime_seconds returned in the response body. |
uptime_human | JSON value | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
vaultProvider | string | Required | Value of vaultProvider returned in the response body. |
deploymentTarget | string | Required | Value of deploymentTarget returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
vaultApiCallsAllowed | boolean | Required | Value of vaultApiCallsAllowed returned in the response body. |
helmInstallAllowed | boolean | Required | Value of helmInstallAllowed returned in the response body. |
helmUpgradeAllowed | boolean | Required | Value of helmUpgradeAllowed returned in the response body. |
kubectlApplyAllowed | boolean | Required | Value of kubectlApplyAllowed returned in the response body. |
vaultInitAllowed | boolean | Required | Value of vaultInitAllowed returned in the response body. |
vaultUnsealAllowed | boolean | Required | Value of vaultUnsealAllowed returned in the response body. |
vaultPolicyMutationAllowed | boolean | Required | Value of vaultPolicyMutationAllowed returned in the response body. |
kubernetesAuthMutationAllowed | boolean | Required | Value of kubernetesAuthMutationAllowed returned in the response body. |
secretWriteAllowed | boolean | Required | Value of secretWriteAllowed returned in the response body. |
injectorMutationAllowed | boolean | Required | Value of injectorMutationAllowed returned in the response body. |
autoUnsealMutationAllowed | boolean | Required | Value of autoUnsealMutationAllowed returned in the response body. |
auditLogReadAllowed | boolean | Required | Value of auditLogReadAllowed returned in the response body. |
rawVaultPayloadsAllowed | boolean | Required | Value of rawVaultPayloadsAllowed returned in the response body. |
rawKubernetesPayloadsAllowed | boolean | Required | Value of rawKubernetesPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
vaultIdentifiersAllowed | boolean | Required | Value of vaultIdentifiersAllowed returned in the response body. |
readinessSurfaces | array<JSON value> | Required | Value of readinessSurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
request | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Value |
200 response body
Structure: Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
source | string | Required | Origin or authority of the returned data. |
readinessMode | string | Required | Value of readinessMode returned in the response body. |
deliveryProvider | string | Required | Value of deliveryProvider returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
vaultApiCallsAllowed | boolean | Required | Value of vaultApiCallsAllowed returned in the response body. |
kubernetesApplyAllowed | boolean | Required | Value of kubernetesApplyAllowed returned in the response body. |
helmInstallAllowed | boolean | Required | Value of helmInstallAllowed returned in the response body. |
helmUpgradeAllowed | boolean | Required | Value of helmUpgradeAllowed returned in the response body. |
crdApplyAllowed | boolean | Required | Value of crdApplyAllowed returned in the response body. |
vaultConnectionMutationAllowed | boolean | Required | Value of vaultConnectionMutationAllowed returned in the response body. |
vaultAuthMutationAllowed | boolean | Required | Value of vaultAuthMutationAllowed returned in the response body. |
vaultStaticSecretMutationAllowed | boolean | Required | Value of vaultStaticSecretMutationAllowed returned in the response body. |
kubernetesSecretMutationAllowed | boolean | Required | Value of kubernetesSecretMutationAllowed returned in the response body. |
secretDataReadAllowed | boolean | Required | Value of secretDataReadAllowed returned in the response body. |
secretDataWriteAllowed | boolean | Required | Value of secretDataWriteAllowed returned in the response body. |
rolloutRestartAllowed | boolean | Required | Value of rolloutRestartAllowed returned in the response body. |
transformationTemplateAllowed | boolean | Required | Value of transformationTemplateAllowed returned in the response body. |
rawVaultPayloadsAllowed | boolean | Required | Value of rawVaultPayloadsAllowed returned in the response body. |
rawKubernetesPayloadsAllowed | boolean | Required | Value of rawKubernetesPayloadsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
vaultIdentifiersAllowed | boolean | Required | Value of vaultIdentifiersAllowed returned in the response body. |
deliverySurfaces | array<JSON value> | Required | Value of deliverySurfaces returned in the response body. |
requiredInputs | array<JSON value> | Required | Value of requiredInputs returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards returned in the response body. |
planSections | array<JSON value> | Required | Value of planSections returned in the response body. |
blockedReasons | array<JSON value> | Required | Value of blockedReasons returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence returned in the response body. |
rules | array<JSON value> | Required | Value 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 class | Credential | Scoping |
|---|---|---|
public | No 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
| Name | Type | Requirement | Description |
|---|---|---|---|
simulate | string | Optional | Set to error to exercise the documented 503 probe response. |
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_json::Value |
200 response body
Structure: serde_json::Value.
| Name | Type | Requirement | Description |
|---|---|---|---|
status | JSON value | Required | Current operation or resource status. |
database | JSON value | Required | Value of database returned in the response body. |
config | JSON value | Required | Value of config returned in the response body. |
auth_mode | JSON value | Required | Value of auth_mode returned in the response body. |
rate_limit_enabled | JSON value | Required | Value 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 class | Credential | Scoping |
|---|---|---|
audit | An 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
| Name | Type | Requirement | Description |
|---|---|---|---|
Authorization | string | Optional | Human 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-Id | string | Optional | Opaque rys_... session-token carrier used by the portal for mutations. Administrative session UUIDs cannot authenticate. Supply exactly one credential carrier per request. |
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | Raw 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 class | Credential | Scoping |
|---|---|---|
public | No 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
| Name | Type | Requirement | Description |
|---|---|---|---|
simulate | string | Optional | Set to error to exercise the documented 503 probe response. |
Request headers
| Name | Type | Requirement | Description |
|---|---|---|---|
traceparent | string | Optional | Optional 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
| Status | Description | Body |
|---|---|---|
200 | OK | serde_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'