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

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 classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/access-control

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
configuredForProductionbooleanRequiredValue of configuredForProduction returned in the response body.
entraGroupsConfiguredbooleanRequiredValue of entraGroupsConfigured returned in the response body.
requiredProductionProviderstringRequiredValue of requiredProductionProvider returned in the response body.
actionsarray<JSON value>RequiredValue of actions returned in the response body.
capabilityPolicystringRequiredValue of capabilityPolicy returned in the response body.
rolesJSON valueRequiredValue of roles returned in the response body.
executionGuardsarray<JSON value>RequiredValue 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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/approval-routes

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
configuredForProductionbooleanRequiredValue of configuredForProduction returned in the response body.
routesarray<JSON value>RequiredValue 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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/categories

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

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

Errors

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

Examples

Request

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

GET/api/catalog/evidence-manifest

audit access

Catalog evidence manifest.

Permissions

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

HTTP request

GET https://<your-host>/api/catalog/evidence-manifest

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
recordTypesarray<JSON value>RequiredValue of recordTypes returned in the response body.
prohibitedContentarray<JSON value>RequiredValue of prohibitedContent returned in the response body.
redactionStatesarray<JSON value>RequiredValue of redactionStates returned in the response body.
exportReadinessarray<JSON value>RequiredValue of exportReadiness returned in the response body.
requiredManifestFieldsarray<JSON value>RequiredValue of requiredManifestFields returned in the response body.
requiredChecksarray<JSON value>RequiredValue of requiredChecks returned in the response body.
safeExportTargetsarray<JSON value>RequiredValue of safeExportTargets returned in the response body.
retentionClassesarray<JSON value>RequiredValue of retentionClasses returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.

Errors

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

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/evidence-redaction-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
redactionModestringRequiredValue of redactionMode returned in the response body.
noSecretScanRequiredbooleanRequiredValue of noSecretScanRequired returned in the response body.
providerSummaryOnlybooleanRequiredValue of providerSummaryOnly returned in the response body.
stackTraceSuppressionbooleanRequiredValue of stackTraceSuppression returned in the response body.
identifierRedactionbooleanRequiredValue of identifierRedaction returned in the response body.
privateNetworkRedactionbooleanRequiredValue of privateNetworkRedaction returned in the response body.
logLineFilteringbooleanRequiredValue of logLineFiltering returned in the response body.
exportReadinessGatebooleanRequiredValue of exportReadinessGate returned in the response body.
safeExportTargetsarray<JSON value>RequiredValue of safeExportTargets returned in the response body.
redactionStatesarray<JSON value>RequiredValue of redactionStates returned in the response body.
exportReadinessarray<JSON value>RequiredValue of exportReadiness returned in the response body.
prohibitedContentarray<JSON value>RequiredValue of prohibitedContent returned in the response body.
requiredChecksarray<JSON value>RequiredValue of requiredChecks returned in the response body.
retentionClassesarray<JSON value>RequiredValue of retentionClasses returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.

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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/offerings-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
catalogModestringRequiredValue of catalogMode returned in the response body.
catalogReadOnlybooleanRequiredValue of catalogReadOnly returned in the response body.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
liveRequestCreationAllowedbooleanRequiredValue of liveRequestCreationAllowed returned in the response body.
liveApprovalExecutionAllowedbooleanRequiredValue of liveApprovalExecutionAllowed returned in the response body.
liveExecutionAllowedbooleanRequiredValue of liveExecutionAllowed returned in the response body.
rawRequestPayloadsAllowedbooleanRequiredValue of rawRequestPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawLogContentAllowedbooleanRequiredValue of rawLogContentAllowed returned in the response body.
rawRowsAllowedbooleanRequiredValue of rawRowsAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
categoriesJSON valueRequiredValue of categories returned in the response body.
offeringsarray<JSON value>RequiredValue 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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/policy-guardrails

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
versionJSON valueRequiredValue of version returned in the response body.
statusJSON valueRequiredCurrent operation or resource status.
ruleCountJSON valueRequiredValue of ruleCount returned in the response body.
rulesJSON valueRequiredValue 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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/policy-guardrails-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
evaluationModestringRequiredValue of evaluationMode returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
livePolicyEvaluationAllowedbooleanRequiredValue of livePolicyEvaluationAllowed returned in the response body.
liveProviderValidationAllowedbooleanRequiredValue of liveProviderValidationAllowed returned in the response body.
requestPayloadEvaluationAllowedbooleanRequiredValue of requestPayloadEvaluationAllowed returned in the response body.
policyMutationAllowedbooleanRequiredValue of policyMutationAllowed returned in the response body.
rawRequestPayloadsAllowedbooleanRequiredValue of rawRequestPayloadsAllowed returned in the response body.
rawPolicyInputsAllowedbooleanRequiredValue of rawPolicyInputsAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
policyFamiliesarray<JSON value>RequiredValue of policyFamilies returned in the response body.
prioritiesarray<JSON value>RequiredValue of priorities returned in the response body.
decisionsarray<JSON value>RequiredValue of decisions returned in the response body.
ruleIdsarray<JSON value>RequiredValue of ruleIds returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

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

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/recommendations-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
recommendationModestringRequiredValue of recommendationMode returned in the response body.
recommendationsReadOnlybooleanRequiredValue of recommendationsReadOnly returned in the response body.
roleDefaultsReadOnlybooleanRequiredValue of roleDefaultsReadOnly returned in the response body.
siteDefaultsReadOnlybooleanRequiredValue of siteDefaultsReadOnly returned in the response body.
evidenceReferencesReadOnlybooleanRequiredValue of evidenceReferencesReadOnly returned in the response body.
livePersonalizationAllowedbooleanRequiredValue of livePersonalizationAllowed returned in the response body.
liveCatalogQueryAllowedbooleanRequiredValue of liveCatalogQueryAllowed returned in the response body.
liveRequestCreationAllowedbooleanRequiredValue of liveRequestCreationAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
identityLookupAllowedbooleanRequiredValue of identityLookupAllowed returned in the response body.
rawUserDataAllowedbooleanRequiredValue of rawUserDataAllowed returned in the response body.
rawApplicationDataAllowedbooleanRequiredValue of rawApplicationDataAllowed returned in the response body.
rawSiteDataAllowedbooleanRequiredValue of rawSiteDataAllowed returned in the response body.
rawRequestPayloadsAllowedbooleanRequiredValue of rawRequestPayloadsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
tokenValuesAllowedbooleanRequiredValue of tokenValuesAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
principalIdentifiersAllowedbooleanRequiredValue of principalIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
recommendedOfferingIdsarray<JSON value>RequiredValue of recommendedOfferingIds returned in the response body.
recommendationDimensionsarray<JSON value>RequiredValue of recommendationDimensions returned in the response body.
recommendationSignalsarray<JSON value>RequiredValue of recommendationSignals returned in the response body.
recommendationViewsarray<JSON value>RequiredValue of recommendationViews returned in the response body.
requiredGuardsarray<JSON value>RequiredValue of requiredGuards returned in the response body.
blockedReasonsarray<JSON value>RequiredValue of blockedReasons returned in the response body.
requiredEvidencearray<JSON value>RequiredValue of requiredEvidence returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

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

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/request-form-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
formModestringRequiredValue of formMode returned in the response body.
formSchemaReadOnlybooleanRequiredValue of formSchemaReadOnly returned in the response body.
schemaDerivedFromOfferingsbooleanRequiredValue of schemaDerivedFromOfferings returned in the response body.
liveRequestCreationAllowedbooleanRequiredValue of liveRequestCreationAllowed returned in the response body.
formSubmissionAllowedbooleanRequiredValue of formSubmissionAllowed returned in the response body.
approvalExecutionAllowedbooleanRequiredValue of approvalExecutionAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
rawRequestPayloadsAllowedbooleanRequiredValue of rawRequestPayloadsAllowed returned in the response body.
rawFormSubmissionsAllowedbooleanRequiredValue of rawFormSubmissionsAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawLogContentAllowedbooleanRequiredValue of rawLogContentAllowed returned in the response body.
rawRowsAllowedbooleanRequiredValue of rawRowsAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
credentialValuesAllowedbooleanRequiredValue of credentialValuesAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
formSectionsarray<JSON value>RequiredValue of formSections returned in the response body.
inputKindsarray<JSON value>RequiredValue of inputKinds returned in the response body.
requiredInputNamesarray<JSON value>RequiredValue of requiredInputNames returned in the response body.
offeringFormsarray<JSON value>RequiredValue of offeringForms returned in the response body.
rulesarray<JSON value>RequiredValue of rules returned in the response body.

Errors

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

Examples

Request

curl --silent --show-error --globoff \
  --request GET \
  --header 'Authorization: Bearer <token>' \
  'https://<your-host>/api/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 classCredentialScoping
auditAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/secret-references

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
providerModelstringRequiredValue of providerModel returned in the response body.
managementInterfacestringRequiredValue of managementInterface returned in the response body.
fallbackPolicystringRequiredValue of fallbackPolicy returned in the response body.
admittedProviderClassesarray<JSON value>RequiredValue of admittedProviderClasses returned in the response body.
capabilityInterfacesarray<JSON value>RequiredValue of capabilityInterfaces returned in the response body.
providerCallsEnabledbooleanRequiredValue of providerCallsEnabled returned in the response body.
secretValuesAllowedbooleanRequiredValue of secretValuesAllowed returned in the response body.
configuredForProductionbooleanRequiredValue of configuredForProduction returned in the response body.
secretReferenceKindsarray<JSON value>RequiredValue of secretReferenceKinds returned in the response body.
readinessStatesarray<JSON value>RequiredValue of readinessStates returned in the response body.
rotationPoliciesarray<JSON value>RequiredValue 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 classCredentialScoping
requestAn authenticated session or API bearer token is required.The access class is enforced first; site and environment scopes narrow resources on scoped operations.

HTTP request

GET https://<your-host>/api/catalog/site-catalog-contract

Path parameters

This operation has no path parameters.

Query parameters

This operation has no query parameters.

Request headers

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

Request body

This operation does not accept a request body.

Response

StatusDescriptionBody
200OKValue

200 response body

Structure: Value.

NameTypeRequirementDescription
sourcestringRequiredOrigin or authority of the returned data.
catalogModestringRequiredValue of catalogMode returned in the response body.
domainstringRequiredValue of domain returned in the response body.
ouPatternstringRequiredValue of ouPattern returned in the response body.
networkstringRequiredValue of network returned in the response body.
organizationstringRequiredValue of organization returned in the response body.
safeXmlFactsOnlybooleanRequiredValue of safeXmlFactsOnly returned in the response body.
providerCallsAllowedbooleanRequiredValue of providerCallsAllowed returned in the response body.
liveValidationAllowedbooleanRequiredValue of liveValidationAllowed returned in the response body.
xmlParsingAllowedbooleanRequiredValue of xmlParsingAllowed returned in the response body.
workflowMutationAllowedbooleanRequiredValue of workflowMutationAllowed returned in the response body.
rawXmlAllowedbooleanRequiredValue of rawXmlAllowed returned in the response body.
encryptedValuesAllowedbooleanRequiredValue of encryptedValuesAllowed returned in the response body.
passwordValuesAllowedbooleanRequiredValue of passwordValuesAllowed returned in the response body.
credentialIdentifiersAllowedbooleanRequiredValue of credentialIdentifiersAllowed returned in the response body.
tenantIdentifiersAllowedbooleanRequiredValue of tenantIdentifiersAllowed returned in the response body.
objectIdentifiersAllowedbooleanRequiredValue of objectIdentifiersAllowed returned in the response body.
privateNetworkValuesAllowedbooleanRequiredValue of privateNetworkValuesAllowed returned in the response body.
rawProviderPayloadsAllowedbooleanRequiredValue of rawProviderPayloadsAllowed returned in the response body.
rawSiteInventoryRowsAllowedbooleanRequiredValue of rawSiteInventoryRowsAllowed returned in the response body.
rawRecipientDataAllowedbooleanRequiredValue of rawRecipientDataAllowed returned in the response body.
windowsBehaviorarray<JSON value>RequiredValue of windowsBehavior returned in the response body.
sitesarray<JSON value>RequiredValue of sites returned in the response body.
requiredEvidencearray<JSON value>RequiredValue 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": []
}
Last updated 2026-07-16 · Generated from the API route registrations.