Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Retrieves information about a policy generation request within the AgentCore Policy system. Policy generation converts natural language descriptions into Cedar policy statements using AI-powered translation, enabling non-technical users to create policies.

get/policy-engines/{policyEngineId}/policy-generations/{policyGenerationId}

Path parameters

policyGenerationIdstring required

The unique identifier of the policy generation request to be retrieved. This must be a valid generation ID from a previous <a href="https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_StartPolicyGeneration.html">StartPolicyGeneration</a> call.

policyEngineIdstring required

The identifier of the policy engine associated with the policy generation request. This provides the context for the generation operation and schema validation.

Response

Success

policyEngineIdstring required

The identifier of the policy engine associated with this policy generation. This confirms the policy engine context for the generation operation.

policyGenerationIdstring required

The unique identifier of the policy generation request. This matches the generation ID provided in the request and serves as the tracking identifier.

namestring required

The customer-assigned name for the policy generation request. This helps identify and track generation operations across multiple requests.

policyGenerationArnstring required

The Amazon Resource Name (ARN) of the policy generation. This globally unique identifier can be used for tracking, auditing, and cross-service references.

createdAtstring date-time required

The timestamp when the policy generation request was created. This is used for tracking and auditing generation operations and their lifecycle.

updatedAtstring date-time required

The timestamp when the policy generation was last updated. This tracks the progress of the generation process and any status changes.

status'GENERATING' | 'GENERATED' | 'GENERATE_FAILED' | 'DELETE_FAILED' required

The current status of the policy generation. This indicates whether the generation is in progress, completed successfully, or failed during processing.

findingsstring

The findings and results from the policy generation process. This includes any issues, recommendations, validation results, or insights from the generated policies.

statusReasonsString[] required

Additional information about the generation status. This provides details about any failures, warnings, or the current state of the generation process.