View a markdown version of this page

Reviewing registry records - Amazon Bedrock AgentCore
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Reviewing registry records

Migration Now Open

Amazon Agent Registry has launched under the new agent-registry namespace. Support for the public preview bedrock-agentcore namespace will be discontinued on September 17, 2026. For migration instructions, see Comprehensive registry migration guide.

Overview

As a curator, you review records in Pending Approval status against your organization’s standards for security, compliance, and metadata quality.

View pending records

As a curator, you can find records awaiting review from the registry detail page, Amazon CLI, or Amazon SDK.

Console

Example
Amazon Agent Registry namespace
  1. Open the Amazon Agent Registry console.

  2. In the navigation pane, choose Registry, and then choose the registry you want to review.

  3. In the Registry records section, the Pending approval status summary counter shows how many records are awaiting review.

  4. Filter the records table by Status to show only records in Pending approval status.

  5. Choose a record’s name to open its detail page and review its content.

Amazon Bedrock AgentCore namespace (to be deprecated)
  1. Open the Amazon Agent Registry page in the Bedrock-AgentCore console.

  2. In the navigation pane, choose Registry, and then choose the registry you want to review.

  3. In the Registry records section, the Pending approval status summary counter shows how many records are awaiting review.

  4. Filter the records table by Status to show only records in Pending approval status.

  5. Choose a record’s name to open its detail page and review its content.

Amazon CLI

Example
Amazon Agent Registry namespace
aws agent-registry-control list-registry-records \ --registry-id "<registryId>" \ --filters '[{"name": "status", "values": ["PENDING_APPROVAL"]}]' \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \ --registry-id "<registryId>" \ --status PENDING_APPROVAL \ --region us-east-1

Amazon SDK

Example
Amazon Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.list_registry_records( registryId='<registryId>', filters=[{'name': 'status', 'values': ['PENDING_APPROVAL']}] ) for record in response['registryRecords']: print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3 client = boto3.client('bedrock-agentcore-control') response = client.list_registry_records( registryId='<registryId>', status='PENDING_APPROVAL' ) for record in response['registryRecords']: print(f"{record['name']} - {record['descriptorType']}")

Approve a record

Console

  1. Open the record detail page for a record in Pending approval status.

  2. Choose the Update status dropdown, then choose Approve.

  3. In the Update status dialog, enter a Reason for the status change.

  4. Choose Update.

Amazon CLI

Example
Amazon Agent Registry namespace
aws agent-registry-control update-registry-record-status \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --status APPROVED \ --status-reason "Reviewed and approved" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record-status \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --status APPROVED \ --status-reason "Reviewed and approved" \ --region us-east-1

Amazon SDK

Example
Amazon Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.update_registry_record_status( registryId='<registryId>', recordId='<recordId>', status='APPROVED', statusReason='Reviewed and approved' ) print(f"Status: {response['status']}") # APPROVED print(f"StatusReason: {response['statusReason']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3 client = boto3.client('bedrock-agentcore-control') response = client.update_registry_record_status( registryId='<registryId>', recordId='<recordId>', status='APPROVED', statusReason='Reviewed and approved' ) print(f"Status: {response['status']}") # APPROVED print(f"StatusReason: {response['statusReason']}")

Reject a record

Console

  1. Open the record detail page for a record in Pending approval status.

  2. Choose the Update status dropdown, then choose Reject.

  3. In the Update status dialog, enter a Reason for the rejection.

  4. Choose Update.

Amazon CLI

Example
Amazon Agent Registry namespace
aws agent-registry-control update-registry-record-status \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --status REJECTED \ --status-reason "Missing tool input schemas" \ --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record-status \ --registry-id "<registryId>" \ --record-id "<recordId>" \ --status REJECTED \ --status-reason "Missing tool input schemas" \ --region us-east-1

Amazon SDK

Example
Amazon Agent Registry namespace
import boto3 client = boto3.client('agent-registry-control') response = client.update_registry_record_status( registryId='<registryId>', recordId='<recordId>', status='REJECTED', statusReason='Missing tool input schemas' ) print(f"Status: {response['status']}") # REJECTED print(f"StatusReason: {response['statusReason']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3 client = boto3.client('bedrock-agentcore-control') response = client.update_registry_record_status( registryId='<registryId>', recordId='<recordId>', status='REJECTED', statusReason='Missing tool input schemas' ) print(f"Status: {response['status']}") # REJECTED print(f"StatusReason: {response['statusReason']}")
Note

Publisher can edit and resubmit, or curator can directly approve a rejected record.