Catalog API
The service-catalog read surface: offering categories and definitions, approval routes, the access-control model, and evidence manifests.
12 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/catalog/access-control
audit access
Catalog access control.
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/catalog/access-control
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. |
configuredForProduction | boolean | Required | Value of configuredForProduction returned in the response body. |
entraGroupsConfigured | boolean | Required | Value of entraGroupsConfigured returned in the response body. |
requiredProductionProvider | string | Required | Value of requiredProductionProvider returned in the response body. |
actions | array<JSON value> | Required | Value of actions returned in the response body. |
capabilityPolicy | string | Required | Value of capabilityPolicy returned in the response body. |
roles | JSON value | Required | Value of roles returned in the response body. |
executionGuards | array<JSON value> | Required | Value of executionGuards 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/catalog/access-control'
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>",
"configuredForProduction": false,
"entraGroupsConfigured": false,
"requiredProductionProvider": "<string>",
"actions": [],
"capabilityPolicy": "<string>",
"roles": null,
"executionGuards": []
}
GET/api/catalog/approval-routes
request access
Catalog approval routes.
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/catalog/approval-routes
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. |
configuredForProduction | boolean | Required | Value of configuredForProduction returned in the response body. |
routes | array<JSON value> | Required | Value of routes 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/catalog/approval-routes'
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>",
"configuredForProduction": false,
"routes": []
}
GET/api/catalog/categories
request access
Catalog categories.
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/catalog/categories
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/catalog/categories'
GET/api/catalog/evidence-manifest
audit access
Catalog evidence manifest.
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/catalog/evidence-manifest
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. |
recordTypes | array<JSON value> | Required | Value of recordTypes returned in the response body. |
prohibitedContent | array<JSON value> | Required | Value of prohibitedContent returned in the response body. |
redactionStates | array<JSON value> | Required | Value of redactionStates returned in the response body. |
exportReadiness | array<JSON value> | Required | Value of exportReadiness returned in the response body. |
requiredManifestFields | array<JSON value> | Required | Value of requiredManifestFields returned in the response body. |
requiredChecks | array<JSON value> | Required | Value of requiredChecks returned in the response body. |
safeExportTargets | array<JSON value> | Required | Value of safeExportTargets returned in the response body. |
retentionClasses | array<JSON value> | Required | Value of retentionClasses returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence 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/catalog/evidence-manifest'
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>",
"recordTypes": [],
"prohibitedContent": [],
"redactionStates": [],
"exportReadiness": [],
"requiredManifestFields": [],
"requiredChecks": [],
"safeExportTargets": [],
"retentionClasses": [],
"requiredEvidence": [],
"blockedReasons": []
}
GET/api/catalog/evidence-redaction-contract
request access
Catalog evidence redaction.
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/catalog/evidence-redaction-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. |
redactionMode | string | Required | Value of redactionMode returned in the response body. |
noSecretScanRequired | boolean | Required | Value of noSecretScanRequired returned in the response body. |
providerSummaryOnly | boolean | Required | Value of providerSummaryOnly returned in the response body. |
stackTraceSuppression | boolean | Required | Value of stackTraceSuppression returned in the response body. |
identifierRedaction | boolean | Required | Value of identifierRedaction returned in the response body. |
privateNetworkRedaction | boolean | Required | Value of privateNetworkRedaction returned in the response body. |
logLineFiltering | boolean | Required | Value of logLineFiltering returned in the response body. |
exportReadinessGate | boolean | Required | Value of exportReadinessGate returned in the response body. |
safeExportTargets | array<JSON value> | Required | Value of safeExportTargets returned in the response body. |
redactionStates | array<JSON value> | Required | Value of redactionStates returned in the response body. |
exportReadiness | array<JSON value> | Required | Value of exportReadiness returned in the response body. |
prohibitedContent | array<JSON value> | Required | Value of prohibitedContent returned in the response body. |
requiredChecks | array<JSON value> | Required | Value of requiredChecks returned in the response body. |
retentionClasses | array<JSON value> | Required | Value of retentionClasses 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. |
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/catalog/evidence-redaction-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>",
"redactionMode": "<string>",
"noSecretScanRequired": false,
"providerSummaryOnly": false,
"stackTraceSuppression": false,
"identifierRedaction": false,
"privateNetworkRedaction": false,
"logLineFiltering": false,
"exportReadinessGate": false,
"safeExportTargets": [],
"redactionStates": [],
"exportReadiness": [],
"prohibitedContent": [],
"requiredChecks": [],
"retentionClasses": [],
"blockedReasons": [],
"requiredEvidence": []
}
GET/api/catalog/offerings-contract
request access
Catalog offerings.
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/catalog/offerings-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. |
catalogMode | string | Required | Value of catalogMode returned in the response body. |
catalogReadOnly | boolean | Required | Value of catalogReadOnly returned in the response body. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
liveRequestCreationAllowed | boolean | Required | Value of liveRequestCreationAllowed returned in the response body. |
liveApprovalExecutionAllowed | boolean | Required | Value of liveApprovalExecutionAllowed returned in the response body. |
liveExecutionAllowed | boolean | Required | Value of liveExecutionAllowed 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. |
rawLogContentAllowed | boolean | Required | Value of rawLogContentAllowed returned in the response body. |
rawRowsAllowed | boolean | Required | Value of rawRowsAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed 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. |
categories | JSON value | Required | Value of categories returned in the response body. |
offerings | array<JSON value> | Required | Value of offerings 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/catalog/offerings-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>",
"catalogMode": "<string>",
"catalogReadOnly": false,
"providerCallsAllowed": false,
"workflowMutationAllowed": false,
"liveRequestCreationAllowed": false,
"liveApprovalExecutionAllowed": false,
"liveExecutionAllowed": false,
"rawRequestPayloadsAllowed": false,
"rawProviderPayloadsAllowed": false,
"rawLogContentAllowed": false,
"rawRowsAllowed": false,
"rawRecipientDataAllowed": false,
"credentialValuesAllowed": false,
"tenantIdentifiersAllowed": false,
"objectIdentifiersAllowed": false,
"privateNetworkValuesAllowed": false,
"categories": null,
"offerings": []
}
GET/api/catalog/policy-guardrails
request access
The REAL parsed guardrail rules from the policy engine (catalog/policy-guardrails.yaml), evaluable per request via /api/requests/{id}/policy-eval.
Distinct from the -contract descriptor above, which is a static readiness disclaimer.
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/catalog/policy-guardrails
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. |
version | JSON value | Required | Value of version returned in the response body. |
status | JSON value | Required | Current operation or resource status. |
ruleCount | JSON value | Required | Value of ruleCount returned in the response body. |
rules | 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/catalog/policy-guardrails'
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>",
"version": null,
"status": null,
"ruleCount": null,
"rules": null
}
GET/api/catalog/policy-guardrails-contract
request access
Catalog policy guardrails.
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/catalog/policy-guardrails-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. |
evaluationMode | string | Required | Value of evaluationMode returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
livePolicyEvaluationAllowed | boolean | Required | Value of livePolicyEvaluationAllowed returned in the response body. |
liveProviderValidationAllowed | boolean | Required | Value of liveProviderValidationAllowed returned in the response body. |
requestPayloadEvaluationAllowed | boolean | Required | Value of requestPayloadEvaluationAllowed returned in the response body. |
policyMutationAllowed | boolean | Required | Value of policyMutationAllowed returned in the response body. |
rawRequestPayloadsAllowed | boolean | Required | Value of rawRequestPayloadsAllowed returned in the response body. |
rawPolicyInputsAllowed | boolean | Required | Value of rawPolicyInputsAllowed 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. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
policyFamilies | array<JSON value> | Required | Value of policyFamilies returned in the response body. |
priorities | array<JSON value> | Required | Value of priorities returned in the response body. |
decisions | array<JSON value> | Required | Value of decisions returned in the response body. |
ruleIds | array<JSON value> | Required | Value of ruleIds returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards 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/catalog/policy-guardrails-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>",
"evaluationMode": "<string>",
"providerCallsEnabled": false,
"livePolicyEvaluationAllowed": false,
"liveProviderValidationAllowed": false,
"requestPayloadEvaluationAllowed": false,
"policyMutationAllowed": false,
"rawRequestPayloadsAllowed": false,
"rawPolicyInputsAllowed": false,
"tenantIdentifiersAllowed": false,
"objectIdentifiersAllowed": false,
"privateNetworkValuesAllowed": false,
"credentialValuesAllowed": false,
"rawProviderPayloadsAllowed": false,
"policyFamilies": [],
"priorities": [],
"decisions": [],
"ruleIds": [],
"requiredGuards": [],
"blockedReasons": [],
"requiredEvidence": [],
"rules": []
}
GET/api/catalog/recommendations-contract
request access
Catalog recommendations.
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/catalog/recommendations-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. |
recommendationMode | string | Required | Value of recommendationMode returned in the response body. |
recommendationsReadOnly | boolean | Required | Value of recommendationsReadOnly returned in the response body. |
roleDefaultsReadOnly | boolean | Required | Value of roleDefaultsReadOnly returned in the response body. |
siteDefaultsReadOnly | boolean | Required | Value of siteDefaultsReadOnly returned in the response body. |
evidenceReferencesReadOnly | boolean | Required | Value of evidenceReferencesReadOnly returned in the response body. |
livePersonalizationAllowed | boolean | Required | Value of livePersonalizationAllowed returned in the response body. |
liveCatalogQueryAllowed | boolean | Required | Value of liveCatalogQueryAllowed returned in the response body. |
liveRequestCreationAllowed | boolean | Required | Value of liveRequestCreationAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
identityLookupAllowed | boolean | Required | Value of identityLookupAllowed returned in the response body. |
rawUserDataAllowed | boolean | Required | Value of rawUserDataAllowed returned in the response body. |
rawApplicationDataAllowed | boolean | Required | Value of rawApplicationDataAllowed returned in the response body. |
rawSiteDataAllowed | boolean | Required | Value of rawSiteDataAllowed 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. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed returned in the response body. |
tokenValuesAllowed | boolean | Required | Value of tokenValuesAllowed 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. |
principalIdentifiersAllowed | boolean | Required | Value of principalIdentifiersAllowed returned in the response body. |
privateNetworkValuesAllowed | boolean | Required | Value of privateNetworkValuesAllowed returned in the response body. |
recommendedOfferingIds | array<JSON value> | Required | Value of recommendedOfferingIds returned in the response body. |
recommendationDimensions | array<JSON value> | Required | Value of recommendationDimensions returned in the response body. |
recommendationSignals | array<JSON value> | Required | Value of recommendationSignals returned in the response body. |
recommendationViews | array<JSON value> | Required | Value of recommendationViews returned in the response body. |
requiredGuards | array<JSON value> | Required | Value of requiredGuards 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/catalog/recommendations-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>",
"recommendationMode": "<string>",
"recommendationsReadOnly": false,
"roleDefaultsReadOnly": false,
"siteDefaultsReadOnly": false,
"evidenceReferencesReadOnly": false,
"livePersonalizationAllowed": false,
"liveCatalogQueryAllowed": false,
"liveRequestCreationAllowed": false,
"workflowMutationAllowed": false,
"providerCallsAllowed": false,
"identityLookupAllowed": false,
"rawUserDataAllowed": false,
"rawApplicationDataAllowed": false,
"rawSiteDataAllowed": false,
"rawRequestPayloadsAllowed": false,
"rawProviderPayloadsAllowed": false,
"rawRecipientDataAllowed": false,
"credentialValuesAllowed": false,
"tokenValuesAllowed": false,
"tenantIdentifiersAllowed": false,
"objectIdentifiersAllowed": false,
"principalIdentifiersAllowed": false,
"privateNetworkValuesAllowed": false,
"recommendedOfferingIds": [],
"recommendationDimensions": [],
"recommendationSignals": [],
"recommendationViews": [],
"requiredGuards": [],
"blockedReasons": [],
"requiredEvidence": [],
"rules": []
}
GET/api/catalog/request-form-contract
request access
Catalog request form.
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/catalog/request-form-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. |
formMode | string | Required | Value of formMode returned in the response body. |
formSchemaReadOnly | boolean | Required | Value of formSchemaReadOnly returned in the response body. |
schemaDerivedFromOfferings | boolean | Required | Value of schemaDerivedFromOfferings returned in the response body. |
liveRequestCreationAllowed | boolean | Required | Value of liveRequestCreationAllowed returned in the response body. |
formSubmissionAllowed | boolean | Required | Value of formSubmissionAllowed returned in the response body. |
approvalExecutionAllowed | boolean | Required | Value of approvalExecutionAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
rawRequestPayloadsAllowed | boolean | Required | Value of rawRequestPayloadsAllowed returned in the response body. |
rawFormSubmissionsAllowed | boolean | Required | Value of rawFormSubmissionsAllowed returned in the response body. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
rawLogContentAllowed | boolean | Required | Value of rawLogContentAllowed returned in the response body. |
rawRowsAllowed | boolean | Required | Value of rawRowsAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
credentialValuesAllowed | boolean | Required | Value of credentialValuesAllowed 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. |
formSections | array<JSON value> | Required | Value of formSections returned in the response body. |
inputKinds | array<JSON value> | Required | Value of inputKinds returned in the response body. |
requiredInputNames | array<JSON value> | Required | Value of requiredInputNames returned in the response body. |
offeringForms | array<JSON value> | Required | Value of offeringForms 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/catalog/request-form-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>",
"formMode": "<string>",
"formSchemaReadOnly": false,
"schemaDerivedFromOfferings": false,
"liveRequestCreationAllowed": false,
"formSubmissionAllowed": false,
"approvalExecutionAllowed": false,
"workflowMutationAllowed": false,
"providerCallsAllowed": false,
"rawRequestPayloadsAllowed": false,
"rawFormSubmissionsAllowed": false,
"rawProviderPayloadsAllowed": false,
"rawLogContentAllowed": false,
"rawRowsAllowed": false,
"rawRecipientDataAllowed": false,
"credentialValuesAllowed": false,
"tenantIdentifiersAllowed": false,
"objectIdentifiersAllowed": false,
"privateNetworkValuesAllowed": false,
"formSections": [],
"inputKinds": [],
"requiredInputNames": [],
"offeringForms": [],
"rules": []
}
GET/api/catalog/secret-references
audit access
Catalog secret references.
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/catalog/secret-references
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. |
providerModel | string | Required | Value of providerModel returned in the response body. |
managementInterface | string | Required | Value of managementInterface returned in the response body. |
fallbackPolicy | string | Required | Value of fallbackPolicy returned in the response body. |
admittedProviderClasses | array<JSON value> | Required | Value of admittedProviderClasses returned in the response body. |
capabilityInterfaces | array<JSON value> | Required | Value of capabilityInterfaces returned in the response body. |
providerCallsEnabled | boolean | Required | Value of providerCallsEnabled returned in the response body. |
secretValuesAllowed | boolean | Required | Value of secretValuesAllowed returned in the response body. |
configuredForProduction | boolean | Required | Value of configuredForProduction returned in the response body. |
secretReferenceKinds | array<JSON value> | Required | Value of secretReferenceKinds returned in the response body. |
readinessStates | array<JSON value> | Required | Value of readinessStates returned in the response body. |
rotationPolicies | array<JSON value> | Required | Value of rotationPolicies 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/catalog/secret-references'
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>",
"providerModel": "<string>",
"managementInterface": "<string>",
"fallbackPolicy": "<string>",
"admittedProviderClasses": [],
"capabilityInterfaces": [],
"providerCallsEnabled": false,
"secretValuesAllowed": false,
"configuredForProduction": false,
"secretReferenceKinds": [],
"readinessStates": [],
"rotationPolicies": []
}
GET/api/catalog/site-catalog-contract
request access
Catalog site catalog.
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/catalog/site-catalog-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. |
catalogMode | string | Required | Value of catalogMode returned in the response body. |
domain | string | Required | Value of domain returned in the response body. |
ouPattern | string | Required | Value of ouPattern returned in the response body. |
network | string | Required | Value of network returned in the response body. |
organization | string | Required | Value of organization returned in the response body. |
safeXmlFactsOnly | boolean | Required | Value of safeXmlFactsOnly returned in the response body. |
providerCallsAllowed | boolean | Required | Value of providerCallsAllowed returned in the response body. |
liveValidationAllowed | boolean | Required | Value of liveValidationAllowed returned in the response body. |
xmlParsingAllowed | boolean | Required | Value of xmlParsingAllowed returned in the response body. |
workflowMutationAllowed | boolean | Required | Value of workflowMutationAllowed returned in the response body. |
rawXmlAllowed | boolean | Required | Value of rawXmlAllowed returned in the response body. |
encryptedValuesAllowed | boolean | Required | Value of encryptedValuesAllowed returned in the response body. |
passwordValuesAllowed | boolean | Required | Value of passwordValuesAllowed returned in the response body. |
credentialIdentifiersAllowed | boolean | Required | Value of credentialIdentifiersAllowed 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. |
rawProviderPayloadsAllowed | boolean | Required | Value of rawProviderPayloadsAllowed returned in the response body. |
rawSiteInventoryRowsAllowed | boolean | Required | Value of rawSiteInventoryRowsAllowed returned in the response body. |
rawRecipientDataAllowed | boolean | Required | Value of rawRecipientDataAllowed returned in the response body. |
windowsBehavior | array<JSON value> | Required | Value of windowsBehavior returned in the response body. |
sites | array<JSON value> | Required | Value of sites returned in the response body. |
requiredEvidence | array<JSON value> | Required | Value of requiredEvidence 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/catalog/site-catalog-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>",
"catalogMode": "<string>",
"domain": "<string>",
"ouPattern": "<string>",
"network": "<string>",
"organization": "<string>",
"safeXmlFactsOnly": false,
"providerCallsAllowed": false,
"liveValidationAllowed": false,
"xmlParsingAllowed": false,
"workflowMutationAllowed": false,
"rawXmlAllowed": false,
"encryptedValuesAllowed": false,
"passwordValuesAllowed": false,
"credentialIdentifiersAllowed": false,
"tenantIdentifiersAllowed": false,
"objectIdentifiersAllowed": false,
"privateNetworkValuesAllowed": false,
"rawProviderPayloadsAllowed": false,
"rawSiteInventoryRowsAllowed": false,
"rawRecipientDataAllowed": false,
"windowsBehavior": [],
"sites": [],
"requiredEvidence": []
}