{
  "version":"2.0",
  "metadata":{
    "apiVersion":"2025-12-01",
    "auth":["aws.auth#sigv4"],
    "endpointPrefix":"agent-registry",
    "protocol":"rest-json",
    "protocols":["rest-json"],
    "serviceFullName":"Agent Registry",
    "serviceId":"Agent Registry",
    "signatureVersion":"v4",
    "signingName":"agent-registry",
    "uid":"agent-registry-2025-12-01"
  },
  "operations":{
    "BatchGetDiscoverableRegistryRecord":{
      "name":"BatchGetDiscoverableRegistryRecord",
      "http":{
        "method":"POST",
        "requestUri":"/discoverable-records-batch",
        "responseCode":200
      },
      "input":{"shape":"BatchGetDiscoverableRegistryRecordRequest"},
      "output":{"shape":"BatchGetDiscoverableRegistryRecordResponse"},
      "errors":[
        {"shape":"InternalServerException"},
        {"shape":"AccessDeniedException"},
        {"shape":"ResourceNotFoundException"},
        {"shape":"ThrottlingException"},
        {"shape":"UnauthorizedException"},
        {"shape":"ValidationException"}
      ]
    },
    "ListDiscoverableRegistryRecords":{
      "name":"ListDiscoverableRegistryRecords",
      "http":{
        "method":"POST",
        "requestUri":"/registries/{registryId}/discoverable-records-list",
        "responseCode":200
      },
      "input":{"shape":"ListDiscoverableRegistryRecordsRequest"},
      "output":{"shape":"ListDiscoverableRegistryRecordsResponse"},
      "errors":[
        {"shape":"InternalServerException"},
        {"shape":"AccessDeniedException"},
        {"shape":"ResourceNotFoundException"},
        {"shape":"ThrottlingException"},
        {"shape":"UnauthorizedException"},
        {"shape":"ValidationException"}
      ],
      "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"}
      ]
    }
  },
  "shapes":{
    "A2aAgentCardDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"},
        "dataSchemaVersion":{"shape":"DataSchemaVersion"},
        "source":{"shape":"DescriptorSource"}
      }
    },
    "AccessDeniedException":{
      "type":"structure",
      "members":{
        "message":{"shape":"NonBlankString"}
      },
      "error":{
        "httpStatusCode":403,
        "senderFault":true
      },
      "exception":true
    },
    "AgUiDescriptor":{
      "type":"structure",
      "members":{
        "source":{"shape":"DescriptorSource"}
      }
    },
    "AgentSkillsAdditionalData":{
      "type":"structure",
      "members":{
        "skillMd":{"shape":"AgentSkillsMdDescriptor"}
      }
    },
    "AgentSkillsDefinitionDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"},
        "dataSchemaVersion":{"shape":"DataSchemaVersion"},
        "additionalData":{"shape":"AgentSkillsAdditionalData"}
      }
    },
    "AgentSkillsMdDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"},
        "dataSchemaVersion":{"shape":"DataSchemaVersion"},
        "source":{"shape":"DescriptorSource"}
      }
    },
    "BatchGetDiscoverableRegistryRecordError":{
      "type":"structure",
      "required":[
        "registryId",
        "recordId",
        "errorCode"
      ],
      "members":{
        "registryId":{"shape":"RegistryIdentifier"},
        "recordId":{"shape":"RecordIdentifier"},
        "errorCode":{"shape":"BatchGetDiscoverableRegistryRecordErrorCode"},
        "message":{"shape":"String"}
      }
    },
    "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"}
      }
    },
    "BatchGetDiscoverableRegistryRecordRequestEntriesList":{
      "type":"list",
      "member":{"shape":"RegistryRecordsEntry"},
      "max":1,
      "min":1
    },
    "BatchGetDiscoverableRegistryRecordResponse":{
      "type":"structure",
      "required":[
        "registryRecords",
        "errors"
      ],
      "members":{
        "registryRecords":{"shape":"RegistryRecordSummaryList"},
        "errors":{"shape":"BatchGetDiscoverableRegistryRecordErrorList"}
      }
    },
    "CustomDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"}
      }
    },
    "CustomMetadataDocument":{
      "type":"structure",
      "members":{},
      "document":true,
      "sensitive":true
    },
    "DataSchemaVersion":{
      "type":"string",
      "max":255,
      "min":1
    },
    "DateTimestamp":{
      "type":"timestamp",
      "timestampFormat":"iso8601"
    },
    "Description":{
      "type":"string",
      "max":4096,
      "min":1,
      "sensitive":true
    },
    "DescriptorData":{
      "type":"string",
      "max":102400,
      "min":1,
      "sensitive":true
    },
    "DescriptorSource":{
      "type":"structure",
      "members":{
        "fromUrl":{"shape":"DescriptorSourceFromUrl"}
      }
    },
    "DescriptorSourceFromUrl":{
      "type":"structure",
      "required":["url"],
      "members":{
        "url":{"shape":"DescriptorSourceUrl"}
      }
    },
    "DescriptorSourceUrl":{
      "type":"string",
      "max":2048,
      "min":1,
      "pattern":"https://.*"
    },
    "DescriptorTypeList":{
      "type":"list",
      "member":{"shape":"String"},
      "max":10,
      "min":0
    },
    "Descriptors":{
      "type":"structure",
      "members":{
        "mcpServer":{"shape":"McpServerDescriptor"},
        "a2aAgentCard":{"shape":"A2aAgentCardDescriptor"},
        "agentSkillsDefinition":{"shape":"AgentSkillsDefinitionDescriptor"},
        "custom":{"shape":"CustomDescriptor"},
        "http":{"shape":"HttpDescriptor"},
        "agui":{"shape":"AgUiDescriptor"}
      }
    },
    "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"},
        "descriptorTypes":{"shape":"DescriptorTypeList"}
      }
    },
    "DiscoverableRegistryRecordSummaryList":{
      "type":"list",
      "member":{"shape":"DiscoverableRegistryRecordSummary"}
    },
    "FilterValue":{
      "type":"string",
      "max":255,
      "min":1
    },
    "HttpDescriptor":{
      "type":"structure",
      "members":{
        "source":{"shape":"DescriptorSource"}
      }
    },
    "InternalServerException":{
      "type":"structure",
      "members":{
        "message":{"shape":"NonBlankString"}
      },
      "error":{"httpStatusCode":500},
      "exception":true,
      "fault":true
    },
    "ListDiscoverableRegistryRecordsRequest":{
      "type":"structure",
      "required":["registryId"],
      "members":{
        "registryId":{
          "shape":"RegistryIdentifier",
          "location":"uri",
          "locationName":"registryId"
        },
        "maxResults":{"shape":"ListDiscoverableRegistryRecordsRequestMaxResultsInteger"},
        "nextToken":{"shape":"ListDiscoverableRegistryRecordsRequestNextTokenString"},
        "filters":{"shape":"RegistryRecordFilterList"}
      }
    },
    "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"},
        "nextToken":{"shape":"String"}
      }
    },
    "McpServerAdditionalData":{
      "type":"structure",
      "members":{
        "tools":{"shape":"McpToolsDescriptor"}
      }
    },
    "McpServerDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"},
        "dataSchemaVersion":{"shape":"DataSchemaVersion"},
        "additionalData":{"shape":"McpServerAdditionalData"},
        "source":{"shape":"DescriptorSource"}
      }
    },
    "McpToolsDescriptor":{
      "type":"structure",
      "members":{
        "data":{"shape":"DescriptorData"},
        "dataSchemaVersion":{"shape":"DataSchemaVersion"}
      }
    },
    "MetadataFilterExpression":{
      "type":"structure",
      "members":{},
      "document":true,
      "sensitive":true
    },
    "NonBlankString":{
      "type":"string",
      "max":2048,
      "min":1,
      "pattern":"[\\s\\S]+"
    },
    "RecordIdentifier":{
      "type":"string",
      "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",
      "enum":[
        "MCP",
        "AGENT",
        "CUSTOM",
        "SKILL",
        "GATEWAY"
      ]
    },
    "RegistryArn":{
      "type":"string",
      "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",
      "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",
      "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",
      "max":255,
      "min":1
    },
    "RegistryRecordFilter":{
      "type":"structure",
      "required":[
        "name",
        "values"
      ],
      "members":{
        "name":{"shape":"RegistryRecordFilterName"},
        "values":{"shape":"DiscoverableFilterValues"}
      }
    },
    "RegistryRecordFilterList":{
      "type":"list",
      "member":{"shape":"RegistryRecordFilter"},
      "max":10,
      "min":0
    },
    "RegistryRecordFilterName":{
      "type":"string",
      "enum":[
        "recordType",
        "descriptorType"
      ]
    },
    "RegistryRecordId":{
      "type":"string",
      "max":12,
      "min":12,
      "pattern":"[a-zA-Z0-9]{12}"
    },
    "RegistryRecordName":{
      "type":"string",
      "max":255,
      "min":1,
      "pattern":"[a-zA-Z0-9][a-zA-Z0-9_\\-\\.\\/]*"
    },
    "RegistryRecordStatus":{
      "type":"string",
      "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"},
        "recordVersion":{"shape":"RegistryRecordVersion"},
        "status":{"shape":"RegistryRecordStatus"},
        "createdAt":{"shape":"DateTimestamp"},
        "updatedAt":{"shape":"DateTimestamp"},
        "customMetadata":{"shape":"CustomMetadataDocument"}
      }
    },
    "RegistryRecordSummaryList":{
      "type":"list",
      "member":{"shape":"RegistryRecordSummary"}
    },
    "RegistryRecordVersion":{
      "type":"string",
      "max":255,
      "min":1,
      "pattern":"[a-zA-Z0-9.-]+"
    },
    "RegistryRecordsEntry":{
      "type":"structure",
      "required":[
        "registryId",
        "recordIds"
      ],
      "members":{
        "registryId":{"shape":"RegistryIdentifier"},
        "recordIds":{"shape":"RegistryRecordsEntryRecordIdsList"}
      }
    },
    "RegistryRecordsEntryRecordIdsList":{
      "type":"list",
      "member":{"shape":"RecordIdentifier"},
      "max":100,
      "min":1
    },
    "ResourceNotFoundException":{
      "type":"structure",
      "members":{
        "message":{"shape":"NonBlankString"}
      },
      "error":{
        "httpStatusCode":404,
        "senderFault":true
      },
      "exception":true
    },
    "SearchDiscoverableRegistryRecordsRequest":{
      "type":"structure",
      "required":[
        "searchQuery",
        "registryIds"
      ],
      "members":{
        "searchQuery":{"shape":"SearchQuery"},
        "registryIds":{"shape":"SearchDiscoverableRegistryRecordsRequestRegistryIdsList"},
        "maxResults":{"shape":"SearchDiscoverableRegistryRecordsRequestMaxResultsInteger"},
        "filters":{"shape":"MetadataFilterExpression"}
      }
    },
    "SearchDiscoverableRegistryRecordsRequestMaxResultsInteger":{
      "type":"integer",
      "box":true,
      "max":20,
      "min":1
    },
    "SearchDiscoverableRegistryRecordsRequestRegistryIdsList":{
      "type":"list",
      "member":{"shape":"RegistryIdentifier"},
      "max":1,
      "min":1
    },
    "SearchDiscoverableRegistryRecordsResponse":{
      "type":"structure",
      "required":["registryRecords"],
      "members":{
        "registryRecords":{"shape":"RegistryRecordSummaryList"}
      }
    },
    "SearchQuery":{
      "type":"string",
      "max":256,
      "min":0,
      "sensitive":true
    },
    "String":{"type":"string"},
    "ThrottlingException":{
      "type":"structure",
      "members":{
        "message":{"shape":"NonBlankString"}
      },
      "error":{
        "httpStatusCode":429,
        "senderFault":true
      },
      "exception":true
    },
    "UnauthorizedException":{
      "type":"structure",
      "members":{
        "message":{"shape":"NonBlankString"}
      },
      "error":{
        "httpStatusCode":401,
        "senderFault":true
      },
      "exception":true
    },
    "ValidationException":{
      "type":"structure",
      "required":[
        "message",
        "reason"
      ],
      "members":{
        "message":{"shape":"String"},
        "reason":{"shape":"ValidationExceptionReason"},
        "fieldList":{"shape":"ValidationExceptionFieldList"}
      },
      "error":{
        "httpStatusCode":400,
        "senderFault":true
      },
      "exception":true
    },
    "ValidationExceptionField":{
      "type":"structure",
      "required":[
        "name",
        "message"
      ],
      "members":{
        "name":{"shape":"String"},
        "message":{"shape":"String"}
      }
    },
    "ValidationExceptionFieldList":{
      "type":"list",
      "member":{"shape":"ValidationExceptionField"}
    },
    "ValidationExceptionReason":{
      "type":"string",
      "enum":[
        "CannotParse",
        "FieldValidationFailed",
        "IdempotentParameterMismatchException",
        "EventInOtherSession",
        "ResourceConflict"
      ]
    }
  }
}
