Retrieves multiple discoverable registry records by ID from a single registry. Records that cannot be retrieved are reported individually in the errors list rather than failing the entire request.
Lists the discoverable registry records in a registry. You can optionally filter and paginate the results.
", "readonly":true }, "SearchDiscoverableRegistryRecords":{ "name":"SearchDiscoverableRegistryRecords", "http":{ "method":"POST", "requestUri":"/discoverable-records-search", "responseCode":200 }, "input":{"shape":"SearchDiscoverableRegistryRecordsRequest"}, "output":{"shape":"SearchDiscoverableRegistryRecordsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"UnauthorizedException"}, {"shape":"ValidationException"} ], "documentation":"Searches the discoverable registry records in a registry using a natural language query. Returns metadata for the matching records ordered by relevance.
" } }, "shapes":{ "A2aAgentCardDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"}, "dataSchemaVersion":{"shape":"DataSchemaVersion"}, "source":{ "shape":"DescriptorSource", "documentation":"The source location from which the A2A (Agent-to-Agent) agent card descriptor content was retrieved.
" } }, "documentation":"Base mixin for A2A agent card descriptor content
" }, "AccessDeniedException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The caller is not authorized to perform the requested action.
", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AgentSkillsAdditionalData":{ "type":"structure", "members":{ "skillMd":{"shape":"AgentSkillsMdDescriptor"} }, "documentation":"Additional data for an agent skills definition descriptor.
" }, "AgentSkillsDefinitionDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"}, "dataSchemaVersion":{"shape":"DataSchemaVersion"}, "additionalData":{ "shape":"AgentSkillsAdditionalData", "documentation":"Additional data for the agent skills definition, such as the skills markdown descriptor.
" } }, "documentation":"Base mixin for agent skills definition descriptor content
" }, "AgentSkillsMdDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"}, "dataSchemaVersion":{"shape":"DataSchemaVersion"}, "source":{ "shape":"DescriptorSource", "documentation":"The source location from which the agent skills markdown content was retrieved.
" } }, "documentation":"Base mixin for agent skills markdown descriptor content
" }, "BatchGetDiscoverableRegistryRecordError":{ "type":"structure", "required":[ "registryId", "recordId", "errorCode" ], "members":{ "registryId":{"shape":"RegistryIdentifier"}, "recordId":{"shape":"RecordIdentifier"}, "errorCode":{ "shape":"BatchGetDiscoverableRegistryRecordErrorCode", "documentation":"The machine-readable reason that the record could not be retrieved.
" }, "message":{ "shape":"String", "documentation":"An optional human-readable detail about the error. Do not parse this value programmatically.
" } }, "documentation":"Describes why a requested record could not be retrieved.
" }, "BatchGetDiscoverableRegistryRecordErrorCode":{ "type":"string", "enum":[ "RESOURCE_NOT_FOUND", "ACCESS_DENIED", "INTERNAL_ERROR" ] }, "BatchGetDiscoverableRegistryRecordErrorList":{ "type":"list", "member":{"shape":"BatchGetDiscoverableRegistryRecordError"} }, "BatchGetDiscoverableRegistryRecordRequest":{ "type":"structure", "required":["entries"], "members":{ "entries":{ "shape":"BatchGetDiscoverableRegistryRecordRequestEntriesList", "documentation":"The registry-scoped groups of record IDs to retrieve. Currently, you can specify exactly one entry.
" } } }, "BatchGetDiscoverableRegistryRecordRequestEntriesList":{ "type":"list", "member":{"shape":"RegistryRecordsEntry"}, "max":1, "min":1 }, "BatchGetDiscoverableRegistryRecordResponse":{ "type":"structure", "required":[ "registryRecords", "errors" ], "members":{ "registryRecords":{ "shape":"RegistryRecordSummaryList", "documentation":" The records that were successfully retrieved. Each record correlates to the request by its recordId.
The per-record errors for records that could not be retrieved. This list is empty when all requested records were returned.
" } } }, "CustomDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"} }, "documentation":"Custom descriptor for user-defined content
" }, "DataSchemaVersion":{ "type":"string", "documentation":"Version of the descriptor type schema
", "max":255, "min":1 }, "DateTimestamp":{ "type":"timestamp", "documentation":"Timestamp in ISO 8601 date-time format
", "timestampFormat":"iso8601" }, "Description":{ "type":"string", "documentation":"Description of the Resource
", "max":4096, "min":1, "sensitive":true }, "DescriptorData":{ "type":"string", "documentation":"Descriptor payload data
", "max":102400, "min":1, "sensitive":true }, "DescriptorSource":{ "type":"structure", "members":{ "fromUrl":{"shape":"DescriptorSourceFromUrl"} }, "documentation":"The source location from which a descriptor's content was retrieved.
" }, "DescriptorSourceFromUrl":{ "type":"structure", "required":["url"], "members":{ "url":{"shape":"DescriptorSourceUrl"} }, "documentation":"Base mixin for descriptor source from URL
" }, "DescriptorSourceUrl":{ "type":"string", "documentation":"URL source for descriptor content
", "max":2048, "min":1, "pattern":"https://.*" }, "Descriptors":{ "type":"structure", "members":{ "mcpServer":{"shape":"McpServerDescriptor"}, "a2aAgentCard":{"shape":"A2aAgentCardDescriptor"}, "agentSkillsDefinition":{"shape":"AgentSkillsDefinitionDescriptor"}, "custom":{"shape":"CustomDescriptor"} }, "documentation":"The protocol-specific descriptors that describe how to connect to and use the registry record.
" }, "DiscoverableFilterValues":{ "type":"list", "member":{"shape":"FilterValue"}, "max":10, "min":1 }, "DiscoverableRegistryRecordSummary":{ "type":"structure", "required":[ "registryArn", "recordArn", "recordId", "name", "recordType", "recordVersion", "status", "createdAt", "updatedAt" ], "members":{ "registryArn":{"shape":"RegistryArn"}, "recordArn":{"shape":"RegistryRecordArn"}, "recordId":{"shape":"RegistryRecordId"}, "name":{"shape":"RegistryRecordName"}, "description":{"shape":"Description"}, "displayName":{"shape":"RegistryRecordDisplayName"}, "recordType":{"shape":"RecordType"}, "recordVersion":{"shape":"RegistryRecordVersion"}, "status":{"shape":"RegistryRecordStatus"}, "createdAt":{"shape":"DateTimestamp"}, "updatedAt":{"shape":"DateTimestamp"} }, "documentation":" Summary information about a discoverable registry record returned by ListDiscoverableRegistryRecords. This summary does not include descriptors.
A single filter value. Constrained by length only; the accepted set of values is filter-specific and validated server-side so enum-style values such as READY or AWS_IAM are accepted.
", "max":255, "min":1 }, "InternalServerException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The request failed due to an unexpected internal error; the caller may retry.
", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "ListDiscoverableRegistryRecordsRequest":{ "type":"structure", "required":["registryId"], "members":{ "registryId":{ "shape":"RegistryIdentifier", "location":"uri", "locationName":"registryId" }, "maxResults":{ "shape":"ListDiscoverableRegistryRecordsRequestMaxResultsInteger", "documentation":"The maximum number of records to return in a single page. Valid values are 1 through 100.
" }, "nextToken":{ "shape":"ListDiscoverableRegistryRecordsRequestNextTokenString", "documentation":"The pagination token returned by a previous request. Use this value to retrieve the next page of results.
" }, "filters":{ "shape":"RegistryRecordFilterList", "documentation":"The filters to apply to the discoverable registry record list.
" } } }, "ListDiscoverableRegistryRecordsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListDiscoverableRegistryRecordsRequestNextTokenString":{ "type":"string", "max":4096, "min":1 }, "ListDiscoverableRegistryRecordsResponse":{ "type":"structure", "required":["registryRecords"], "members":{ "registryRecords":{ "shape":"DiscoverableRegistryRecordSummaryList", "documentation":"The page of discoverable registry record summaries.
" }, "nextToken":{ "shape":"String", "documentation":"The pagination token to pass to a subsequent request to retrieve the next page of results. This field is absent when there are no more results.
" } } }, "McpServerAdditionalData":{ "type":"structure", "members":{ "tools":{"shape":"McpToolsDescriptor"} }, "documentation":"Additional data for an MCP server descriptor
" }, "McpServerDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"}, "dataSchemaVersion":{"shape":"DataSchemaVersion"}, "additionalData":{"shape":"McpServerAdditionalData"}, "source":{ "shape":"DescriptorSource", "documentation":"The source location from which the MCP (Model Context Protocol) server descriptor content was retrieved.
" } }, "documentation":"Base mixin for MCP server descriptor content
" }, "McpToolsDescriptor":{ "type":"structure", "members":{ "data":{"shape":"DescriptorData"}, "dataSchemaVersion":{"shape":"DataSchemaVersion"} }, "documentation":"MCP tools descriptor containing tool definitions
" }, "MetadataFilterExpression":{ "type":"structure", "members":{}, "document":true, "sensitive":true }, "NonBlankString":{ "type":"string", "max":2048, "min":1, "pattern":"[\\s\\S]+" }, "RecordIdentifier":{ "type":"string", "documentation":"Record identifier that accepts either ARN or ID format
", "max":2048, "min":1, "pattern":"(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/)?[a-zA-Z0-9]{12}" }, "RecordType":{ "type":"string", "documentation":"Record type enum for registry record classification
", "enum":[ "MCP", "AGENT", "CUSTOM", "SKILL" ] }, "RegistryArn":{ "type":"string", "documentation":"Registry Amazon Resource Name
", "max":2048, "min":46, "pattern":"arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}" }, "RegistryIdentifier":{ "type":"string", "documentation":"Registry identifier that accepts either ARN or ID format
", "max":2048, "min":1, "pattern":"(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/)?[a-zA-Z0-9]{12,16}" }, "RegistryRecordArn":{ "type":"string", "documentation":"Registry Record Amazon Resource Name
", "max":2048, "min":1, "pattern":"arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/[a-zA-Z0-9]{12}" }, "RegistryRecordDisplayName":{ "type":"string", "documentation":"Display name for a registry record
", "max":255, "min":1 }, "RegistryRecordFilter":{ "type":"structure", "required":[ "name", "values" ], "members":{ "name":{ "shape":"RegistryRecordFilterName", "documentation":"The attribute to filter on.
" }, "values":{ "shape":"DiscoverableFilterValues", "documentation":"The values to match for the attribute.
" } }, "documentation":" A single filter applied to a ListDiscoverableRegistryRecords request.
The list of filters applied to a ListDiscoverableRegistryRecords request.
The attribute to filter registry records on.
", "enum":[ "recordType", "descriptorType" ] }, "RegistryRecordId":{ "type":"string", "documentation":"Registry Record unique identifier - 12-character alphanumeric string
", "max":12, "min":12, "pattern":"[a-zA-Z0-9]{12}" }, "RegistryRecordName":{ "type":"string", "documentation":"Registry Record name
", "max":255, "min":1, "pattern":"[a-zA-Z0-9][a-zA-Z0-9_\\-\\.\\/]*" }, "RegistryRecordStatus":{ "type":"string", "documentation":"Registry record status
", "enum":[ "DRAFT", "PENDING_APPROVAL", "APPROVED", "REJECTED", "DEPRECATED", "CREATING", "UPDATING", "CREATE_FAILED", "UPDATE_FAILED" ] }, "RegistryRecordSummary":{ "type":"structure", "required":[ "registryArn", "recordArn", "recordId", "name", "recordType", "descriptors", "recordVersion", "status", "createdAt", "updatedAt" ], "members":{ "registryArn":{"shape":"RegistryArn"}, "recordArn":{"shape":"RegistryRecordArn"}, "recordId":{"shape":"RegistryRecordId"}, "name":{"shape":"RegistryRecordName"}, "description":{"shape":"Description"}, "displayName":{"shape":"RegistryRecordDisplayName"}, "recordType":{"shape":"RecordType"}, "descriptors":{ "shape":"Descriptors", "documentation":"The protocol-specific descriptors that describe how to connect to and use the record.
" }, "recordVersion":{"shape":"RegistryRecordVersion"}, "status":{"shape":"RegistryRecordStatus"}, "createdAt":{"shape":"DateTimestamp"}, "updatedAt":{"shape":"DateTimestamp"} }, "documentation":"Summary information about a registry record, including its descriptors.
" }, "RegistryRecordSummaryList":{ "type":"list", "member":{"shape":"RegistryRecordSummary"} }, "RegistryRecordVersion":{ "type":"string", "documentation":"Version of the registry record
", "max":255, "min":1, "pattern":"[a-zA-Z0-9.-]+" }, "RegistryRecordsEntry":{ "type":"structure", "required":[ "registryId", "recordIds" ], "members":{ "registryId":{"shape":"RegistryIdentifier"}, "recordIds":{ "shape":"RegistryRecordsEntryRecordIdsList", "documentation":"The record IDs to retrieve from the registry. You can specify 1 through 100 record IDs.
" } }, "documentation":"Binds one registry to the record IDs requested from it.
" }, "RegistryRecordsEntryRecordIdsList":{ "type":"list", "member":{"shape":"RecordIdentifier"}, "max":100, "min":1 }, "ResourceNotFoundException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The requested resource was not found.
", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "SearchDiscoverableRegistryRecordsRequest":{ "type":"structure", "required":[ "searchQuery", "registryIds" ], "members":{ "searchQuery":{ "shape":"SearchQuery", "documentation":"The natural language query to search for matching registry records.
" }, "registryIds":{ "shape":"SearchDiscoverableRegistryRecordsRequestRegistryIdsList", "documentation":"The registry identifiers to search within. Currently, you must specify exactly one registry identifier. You can provide either the full Amazon Web Services Resource Name (ARN) or the registry ID.
" }, "maxResults":{ "shape":"SearchDiscoverableRegistryRecordsRequestMaxResultsInteger", "documentation":"The maximum number of results to return. Valid values are 1 through 20. The default value is 10.
" }, "filters":{ "shape":"MetadataFilterExpression", "documentation":" An optional structured JSON metadata filter that narrows the search results. Supports the field-level operators $eq, $ne, and $in, and the logical operators $and and $or on filterable fields.
The registry records that match the search query, ordered by relevance.
" } } }, "SearchQuery":{ "type":"string", "max":256, "min":0, "sensitive":true }, "String":{"type":"string"}, "ThrottlingException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The request was denied due to request throttling; the caller may retry after a delay.
", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true }, "UnauthorizedException":{ "type":"structure", "members":{ "message":{"shape":"NonBlankString"} }, "documentation":"The request could not be authenticated.
", "error":{ "httpStatusCode":401, "senderFault":true }, "exception":true }, "ValidationException":{ "type":"structure", "required":[ "message", "reason" ], "members":{ "message":{"shape":"String"}, "reason":{ "shape":"ValidationExceptionReason", "documentation":"The reason the request failed validation.
" }, "fieldList":{ "shape":"ValidationExceptionFieldList", "documentation":"The list of input fields that failed validation.
" } }, "documentation":"The request failed validation of one or more input fields.
", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "ValidationExceptionField":{ "type":"structure", "required":[ "name", "message" ], "members":{ "name":{ "shape":"String", "documentation":"The name of the field that failed validation.
" }, "message":{ "shape":"String", "documentation":"A description of why the field failed validation.
" } }, "documentation":"Describes a single input field that failed validation.
" }, "ValidationExceptionFieldList":{ "type":"list", "member":{"shape":"ValidationExceptionField"} }, "ValidationExceptionReason":{ "type":"string", "enum":[ "CannotParse", "FieldValidationFailed", "IdempotentParameterMismatchException", "EventInOtherSession", "ResourceConflict" ] } }, "documentation":"Agent Registry lets callers discover, list, and retrieve approved records published to a registry.
" }