{ "smithy": "2.0", "shapes": { "com.amazonaws.agentregistrycontrol#A2aAgentCardDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The A2A agent card content, serialized as descriptor payload data.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The schema version of the descriptor payload.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource", "traits": { "smithy.api#documentation": "

The optional source configuration used to synchronize the A2A agent card descriptor content.

" } } }, "traits": { "smithy.api#documentation": "

Descriptor that defines the content of an A2A (Agent-to-Agent) agent card registry record. The content is validated against the A2A protocol schema.

" } }, "com.amazonaws.agentregistrycontrol#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The caller is not authorized to perform the requested action.

", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.agentregistrycontrol#AgUiDescriptor": { "type": "structure", "members": { "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource" } }, "traits": { "smithy.api#documentation": "

A registry record descriptor for the AG-UI (Agent-User Interaction) protocol.

" } }, "com.amazonaws.agentregistrycontrol#AgentCoreGatewayProtocolType": { "type": "enum", "members": { "MCP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "MCP" } } } }, "com.amazonaws.agentregistrycontrol#AgentCoreGatewaySourceDetails": { "type": "structure", "members": { "protocolType": { "target": "com.amazonaws.agentregistrycontrol#AgentCoreGatewayProtocolType", "traits": { "smithy.api#documentation": "

The protocol type of the AgentCore Gateway resource that the registry record was detected from, for example MCP.

" } }, "authorizerType": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The type of authorizer configured on the AgentCore Gateway resource that the registry record was detected from.

" } }, "authorizerConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AuthorizerConfiguration" }, "workloadIdentityDetails": { "target": "com.amazonaws.agentregistrycontrol#WorkloadIdentityDetails", "traits": { "smithy.api#documentation": "

The workload identity details for the AgentCore Gateway resource. Present when the gateway has a workload identity configured.

" } } }, "traits": { "smithy.api#documentation": "

The source details for a registry record that was auto-detected from an Amazon Bedrock AgentCore Gateway resource.

" } }, "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeProtocolConfiguration": { "type": "structure", "members": { "serverProtocol": { "target": "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeServerProtocol", "traits": { "smithy.api#documentation": "

The server protocol used by the AgentCore Runtime, such as MCP, HTTP, A2A, or AGUI.

" } } }, "traits": { "smithy.api#documentation": "

The protocol configuration of an AgentCore Runtime resource that a registry record was auto-detected from.

" } }, "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeServerProtocol": { "type": "enum", "members": { "HTTP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "HTTP" } }, "A2A": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "A2A" } }, "MCP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "MCP" } }, "AGUI": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AGUI" } } } }, "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeSourceDetails": { "type": "structure", "members": { "protocolConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeProtocolConfiguration", "traits": { "smithy.api#documentation": "

The protocol configuration of the AgentCore Runtime resource that the registry record was detected from.

" } }, "authorizerConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AuthorizerConfiguration" }, "workloadIdentityDetails": { "target": "com.amazonaws.agentregistrycontrol#WorkloadIdentityDetails", "traits": { "smithy.api#documentation": "

The workload identity details for the AgentCore Runtime resource. Present when the runtime has a workload identity configured.

" } } }, "traits": { "smithy.api#documentation": "

The source details for a registry record that was auto-detected from an Amazon Bedrock AgentCore Runtime resource.

" } }, "com.amazonaws.agentregistrycontrol#AgentRegistryControl": { "type": "service", "version": "2025-12-01", "operations": [ { "target": "com.amazonaws.agentregistrycontrol#ListTagsForResource" }, { "target": "com.amazonaws.agentregistrycontrol#TagResource" }, { "target": "com.amazonaws.agentregistrycontrol#UntagResource" } ], "resources": [ { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordResource" }, { "target": "com.amazonaws.agentregistrycontrol#RegistryResource" } ], "traits": { "aws.api#service": { "sdkId": "Agent Registry Control", "arnNamespace": "agent-registry", "endpointPrefix": "agent-registry-control", "cloudTrailEventSource": "agent-registry.amazonaws.com" }, "aws.auth#sigv4": { "name": "agent-registry" }, "aws.protocols#restJson1": {}, "smithy.api#cors": { "additionalAllowedHeaders": [ "*", "content-type", "x-amz-content-sha256", "x-amz-user-agent", "x-amzn-platform-id", "x-amzn-trace-id" ], "additionalExposedHeaders": [ "x-amzn-errortype", "x-amzn-requestid", "x-amzn-trace-id" ], "maxAge": 86400 }, "smithy.api#documentation": "

Amazon Web Services Agent Registry is a managed catalog for publishing and discovering resources such as MCP servers, agents, and agent skills. Agent Registry Control is its control-plane API: use it to create and manage registries and the records they contain, configure discovery and authorization, govern record approval and curation workflows, and manage automatic detection of resources. Data-plane search and MCP invocation operations are provided by the companion Agent Registry API.

", "smithy.api#title": "Agent Registry Control", "smithy.rules#endpointBdd": { "version": "1.1", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region of the service.", "type": "string" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send requests.", "type": "string" } }, "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "results": [ { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://agent-registry-control.{Region}.api.aws", "properties": {}, "headers": {} }, "type": "endpoint" }, { "documentation": "Region is required to resolve an endpoint.", "conditions": [], "error": "Unable to resolve an Agent Registry Control endpoint: Region was not set and no explicit Endpoint override was provided.", "type": "error" } ], "root": 2, "nodeCount": 3, "nodes": "/////wAAAAH/////AAAAAAX14QEAAAADAAAAAQX14QIF9eED" }, "smithy.rules#endpointRuleSet": { "version": "1.0", "parameters": { "Region": { "required": false, "type": "String", "builtIn": "AWS::Region", "documentation": "The AWS region of the service." }, "Endpoint": { "required": false, "type": "String", "builtIn": "SDK::Endpoint", "documentation": "Override the endpoint used to send requests." } }, "rules": [ { "documentation": "Explicit endpoint override wins.", "type": "endpoint", "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ], "endpoint": { "url": { "ref": "Endpoint" } } }, { "documentation": "Region-based production endpoint.", "type": "endpoint", "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "endpoint": { "url": "https://agent-registry-control.{Region}.api.aws" } }, { "documentation": "Region is required to resolve an endpoint.", "type": "error", "conditions": [], "error": "Unable to resolve an Agent Registry Control endpoint: Region was not set and no explicit Endpoint override was provided." } ] }, "smithy.rules#endpointTests": { "version": "1.0", "testCases": [ { "documentation": "Region us-west-2 -> region-based prod host.", "params": { "Region": "us-west-2" }, "expect": { "endpoint": { "url": "https://agent-registry-control.us-west-2.api.aws" } } }, { "documentation": "Region us-east-1 -> region-based prod host.", "params": { "Region": "us-east-1" }, "expect": { "endpoint": { "url": "https://agent-registry-control.us-east-1.api.aws" } } }, { "documentation": "Endpoint override wins over region.", "params": { "Region": "us-west-2", "Endpoint": "https://custom.example.aws.dev" }, "expect": { "endpoint": { "url": "https://custom.example.aws.dev" } } } ] } } }, "com.amazonaws.agentregistrycontrol#AgentSkillsAdditionalData": { "type": "structure", "members": { "skillMd": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsMdDescriptor", "traits": { "smithy.api#documentation": "

The markdown skill content associated with an agent skills definition.

" } }, "skillPackage": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsPackageDescriptor", "traits": { "smithy.api#documentation": "

The source that the registry synchronizes the full skill package from. The registry validates and stores the package, sets skillMd.data from its SKILL.md, and returns the package in the artifact member of GetRegistryRecord. You can't set both this source and skillMd.source.

" } }, "repositoryProvider": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsRepositoryProvider", "traits": { "smithy.api#documentation": "

The repository provider of the record's skill source. Set it to GITHUB when skillMd.source or skillPackage.source is a GitHub folder URL. The registry treats an https:// source as a GitHub source only when this member is set. Don't set it for an Amazon S3 source.

" } }, "sourceConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsSourceConfiguration", "traits": { "smithy.api#documentation": "

The provider-specific settings of the record's skill source. For an Amazon S3 source, s3.bucketOwnerAccountId specifies the account that owns the source bucket.

" } } }, "traits": { "smithy.api#documentation": "

Additional data associated with an agent skills definition descriptor: the skill's SKILL.md and the source that the registry synchronizes the skill from. A record synchronizes from one source at most, either skillMd.source for SKILL.md only or skillPackage.source for the full skill package. When the record has a skill package or a synchronized source, the registry sets skillMd.data from the SKILL.md in that package or source.

" } }, "com.amazonaws.agentregistrycontrol#AgentSkillsDefinitionDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The agent skills definition content, serialized as descriptor payload data.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The schema version of the descriptor payload.

" } }, "additionalData": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsAdditionalData", "traits": { "smithy.api#documentation": "

Additional data associated with the agent skills definition descriptor.

" } } }, "traits": { "smithy.api#documentation": "

Descriptor that defines an agent skills registry record and its associated content.

" } }, "com.amazonaws.agentregistrycontrol#AgentSkillsMdDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The agent skills markdown content, serialized as descriptor payload data.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The schema version of the descriptor payload.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource", "traits": { "smithy.api#documentation": "

The optional source of the skill's SKILL.md only. The registry synchronizes the SKILL.md from this source into data. Specify an s3:// URL of a SKILL.md object, or a GitHub folder URL together with repositoryProvider set to GITHUB. The registry rejects a new https:// URL without repositoryProvider, and you can't set both this source and skillPackage.source.

" } } }, "traits": { "smithy.api#documentation": "

Markdown-format descriptor containing an agent skills document.

" } }, "com.amazonaws.agentregistrycontrol#AgentSkillsPackageDescriptor": { "type": "structure", "members": { "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource", "traits": { "smithy.api#documentation": "

The source of the skill package. Specify an s3:// URL of a ZIP object, or a GitHub folder URL together with repositoryProvider set to GITHUB. For a GitHub folder, the registry builds the package from every file in the folder.

" } } }, "traits": { "smithy.api#documentation": "

Descriptor that names the source that the registry synchronizes a full skill package from. It holds only the source. The record's artifact member returns the package that the registry reads from this source.

" } }, "com.amazonaws.agentregistrycontrol#AgentSkillsRepositoryProvider": { "type": "enum", "members": { "GITHUB": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "GITHUB" } } }, "traits": { "smithy.api#documentation": "

The repository provider of a skill source. GITHUB covers GitHub.com, GitHub Enterprise Cloud with data residency (*.ghe.com), and GitHub Enterprise Server hosts that are reachable from the internet.

" } }, "com.amazonaws.agentregistrycontrol#AgentSkillsSourceConfiguration": { "type": "union", "members": { "s3": { "target": "com.amazonaws.agentregistrycontrol#S3SourceConfiguration", "traits": { "smithy.api#documentation": "

The settings of an Amazon S3 source.

" } } }, "traits": { "smithy.api#documentation": "

The provider-specific settings of a skill source. Specify the member that matches the source's provider, such as s3 for an Amazon S3 source.

" } }, "com.amazonaws.agentregistrycontrol#AllowedAudience": { "type": "string", "traits": { "smithy.api#documentation": "

An audience value that an inbound JWT must contain to be authorized.

", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#AllowedAudienceList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#AllowedAudience" }, "traits": { "smithy.api#documentation": "

The list of audience values accepted during JWT validation.

", "smithy.api#length": { "min": 1 } } }, "com.amazonaws.agentregistrycontrol#AllowedClient": { "type": "string", "traits": { "smithy.api#documentation": "

A client identifier that an inbound JWT must be issued to in order to be authorized.

", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#AllowedClientsList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#AllowedClient" }, "traits": { "smithy.api#documentation": "

The list of client identifiers accepted during JWT validation.

", "smithy.api#length": { "min": 1 } } }, "com.amazonaws.agentregistrycontrol#AllowedScopeType": { "type": "string", "traits": { "smithy.api#documentation": "

A scope value that an inbound JWT must carry to be authorized.

", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[\\x21\\x23-\\x5B\\x5D-\\x7E]+$" } }, "com.amazonaws.agentregistrycontrol#AllowedScopesType": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#AllowedScopeType" }, "traits": { "smithy.api#documentation": "

The list of scopes accepted during JWT validation.

", "smithy.api#length": { "min": 1 } } }, "com.amazonaws.agentregistrycontrol#ApprovalConfiguration": { "type": "structure", "members": { "autoApprovalRules": { "target": "com.amazonaws.agentregistrycontrol#AutoApprovalRuleList", "traits": { "smithy.api#documentation": "

The rules that determine which registry records are automatically approved on submission. When omitted or empty, submitted records require manual review.

" } } }, "traits": { "smithy.api#documentation": "

Configuration for the registry's record approval workflow. Controls whether records submitted for approval require manual review before they become approved and discoverable, or are auto-approved. When no auto-approval rules are configured, submitted records require manual review.

" } }, "com.amazonaws.agentregistrycontrol#ArtifactContent": { "type": "blob", "traits": { "smithy.api#documentation": "

The bytes of a skill package ZIP archive, up to 5 MiB (5,242,880 bytes) before base64 encoding.

", "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#AuthorizationAttemptId": { "type": "string", "traits": { "smithy.api#documentation": "

The identifier of an OAuth 2.0 authorization attempt.

", "smithy.api#length": { "min": 1, "max": 64 }, "smithy.api#pattern": "^[A-Za-z0-9_-]+$" } }, "com.amazonaws.agentregistrycontrol#AuthorizationData": { "type": "union", "members": { "oauth2": { "target": "com.amazonaws.agentregistrycontrol#OAuth2AuthorizationData", "traits": { "smithy.api#documentation": "

The OAuth 2.0 authorization that a GitHub user must approve.

" } } }, "traits": { "smithy.api#documentation": "

The authorization that a user must complete before a registry record can synchronize from its source. Only CreateRegistryRecord and UpdateRegistryRecord return it. GetRegistryRecord and ListRegistryRecords never do.

" } }, "com.amazonaws.agentregistrycontrol#AuthorizerConfiguration": { "type": "union", "members": { "customJWTAuthorizer": { "target": "com.amazonaws.agentregistrycontrol#CustomJWTAuthorizerConfiguration", "traits": { "smithy.api#documentation": "

Configuration for a custom JWT authorizer.

" } } }, "traits": { "smithy.api#documentation": "

The authorizer configuration for a registry. Exactly one member is set.

" } }, "com.amazonaws.agentregistrycontrol#AuthorizingClaimMatchValueType": { "type": "structure", "members": { "claimMatchValue": { "target": "com.amazonaws.agentregistrycontrol#ClaimMatchValueType", "traits": { "smithy.api#documentation": "

The expected value or values that the claim is compared against.

", "smithy.api#required": {} } }, "claimMatchOperator": { "target": "com.amazonaws.agentregistrycontrol#ClaimMatchOperatorType", "traits": { "smithy.api#documentation": "

The operator used to compare the claim value against the expected value.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The value and match operator used to authorize a claim during JWT validation.

" } }, "com.amazonaws.agentregistrycontrol#AutoApprovalRule": { "type": "enum", "members": { "APPROVE_ALL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "APPROVE_ALL" } } } }, "com.amazonaws.agentregistrycontrol#AutoApprovalRuleList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#AutoApprovalRule" }, "traits": { "smithy.api#length": { "max": 10 } } }, "com.amazonaws.agentregistrycontrol#AutoDetection": { "type": "structure", "members": { "configuration": { "target": "com.amazonaws.agentregistrycontrol#AutoDetectionConfiguration", "traits": { "smithy.api#documentation": "

The auto-detection settings that control how resources are discovered for the registry.

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#AutoDetectionStatus", "traits": { "smithy.api#documentation": "

The current auto-detection status. ACTIVE indicates that the registry is actively being populated with detected resources. INACTIVE indicates that the preconditions required at the configured scope are not currently met.

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

A human-readable explanation of the current auto-detection status. Typically populated when the status requires additional context.

" } } }, "traits": { "smithy.api#documentation": "

The auto-detection properties for a registry, including the requested configuration and the current detection status. When auto-detection is enabled and the scope preconditions are met, the registry is automatically populated with discovered resources.

" } }, "com.amazonaws.agentregistrycontrol#AutoDetectionConfiguration": { "type": "structure", "members": { "scope": { "target": "com.amazonaws.agentregistrycontrol#AutoDetectionScope", "traits": { "smithy.api#documentation": "

The source from which resources are detected. For example, ORGANIZATION sources resources from all member accounts of an Amazon Web Services organization.

", "smithy.api#required": {} } }, "enabled": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether auto-detection is requested for the registry. Setting this to true is necessary but not sufficient for auto-detection to become active; the preconditions of the configured scope must also be met.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The customer-defined auto-detection settings for a registry.

" } }, "com.amazonaws.agentregistrycontrol#AutoDetectionScope": { "type": "enum", "members": { "ORGANIZATION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ORGANIZATION" } } } }, "com.amazonaws.agentregistrycontrol#AutoDetectionStatus": { "type": "enum", "members": { "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ACTIVE" } }, "INACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "INACTIVE" } } } }, "com.amazonaws.agentregistrycontrol#ClaimMatchOperatorType": { "type": "enum", "members": { "EQUALS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EQUALS" } }, "CONTAINS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CONTAINS" } }, "CONTAINS_ANY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CONTAINS_ANY" } } }, "traits": { "smithy.api#documentation": "

The operator used to compare a claim value against the expected value during JWT validation.

" } }, "com.amazonaws.agentregistrycontrol#ClaimMatchValueType": { "type": "union", "members": { "matchValueString": { "target": "com.amazonaws.agentregistrycontrol#MatchValueString", "traits": { "smithy.api#documentation": "

A single string value to match the claim against.

" } }, "matchValueStringList": { "target": "com.amazonaws.agentregistrycontrol#MatchValueStringList", "traits": { "smithy.api#documentation": "

A list of string values to match the claim against.

" } } }, "traits": { "smithy.api#documentation": "

The expected value used to match a claim. Exactly one member is set.

" } }, "com.amazonaws.agentregistrycontrol#ClientToken": { "type": "string", "traits": { "smithy.api#documentation": "

Client specified token used for idempotency checks

", "smithy.api#length": { "min": 33, "max": 256 }, "smithy.api#pattern": "^[a-zA-Z0-9](-*[a-zA-Z0-9]){0,256}$" } }, "com.amazonaws.agentregistrycontrol#ConflictException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The request conflicts with the current state of the resource.

", "smithy.api#error": "client", "smithy.api#httpError": 409 } }, "com.amazonaws.agentregistrycontrol#CreateRegistry": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistryRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistryResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ServiceQuotaExceededException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Creates a new registry, a catalog that organizes registry records and defines their discovery authorization and record approval behavior. Creation is asynchronous: the registry begins in the CREATING status and becomes usable once it reaches READY.

", "smithy.api#http": { "code": 202, "method": "POST", "uri": "/registries" }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#CreateRegistryRecord": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistryRecordRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistryRecordResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ServiceQuotaExceededException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Creates a registry record within a registry. A registry record describes a discoverable resource, such as an MCP server, an agent, an agent skill, or a custom resource. For an agent skill, you can upload a skill package in artifact, or synchronize the skill from an Amazon S3 or GitHub source. Creation is asynchronous: the operation returns the record with the CREATING status while the registry processes it. If a GitHub user must first authorize access to the source, the operation returns the record with the CREATE_PENDING_AUTH status instead.

", "smithy.api#http": { "method": "POST", "uri": "/registries/{registryId}/records", "code": 202 }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#CreateRegistryRecordRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry in which to create the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordName", "traits": { "smithy.api#documentation": "

The name of the registry record

", "smithy.api#required": {} } }, "displayName": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName", "traits": { "smithy.api#documentation": "

The human-readable display name of the registry record

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

The description of the registry record

" } }, "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The type of the registry record, which determines the descriptor format

", "smithy.api#required": {} } }, "descriptors": { "target": "com.amazonaws.agentregistrycontrol#Descriptors", "traits": { "smithy.api#documentation": "

The typed descriptor content for the registry record

", "smithy.api#required": {} } }, "artifact": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArtifactUpload", "traits": { "smithy.api#documentation": "

The skill package to store with the record, for a record of type SKILL with an agentSkillsDefinition descriptor. The registry validates the package after the operation returns and sets skillMd.data from the package's SKILL.md. A request that uploads a package can't also set a skill source or send new skillMd.data.

" } }, "recordVersion": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordVersion", "traits": { "smithy.api#documentation": "

The version of the registry record

" } }, "clientToken": { "target": "com.amazonaws.agentregistrycontrol#ClientToken", "traits": { "smithy.api#documentation": "

Client token for idempotency

", "smithy.api#idempotencyToken": {} } }, "provenance": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceList", "traits": { "smithy.api#documentation": "

The provenance lineage entries for the registry record. This field is reserved for the Amazon Web Services Agent Registry auto-detection service principal. Requests that include this field from other callers are rejected.

" } }, "customMetadata": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataDocument", "traits": { "smithy.api#documentation": "

The custom metadata for the record. Values are strings or JSON booleans.

" } }, "tags": { "target": "com.amazonaws.agentregistrycontrol#TagsMap", "traits": { "smithy.api#documentation": "

Tags to associate with the registry record

" } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#CreateRegistryRecordResponse": { "type": "structure", "members": { "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The ARN of the created registry record

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The status of the registry record. CREATING means that the asynchronous workflow is in progress. CREATE_PENDING_AUTH means that the record waits for a GitHub user to authorize access before it synchronizes from its GitHub source. For the authorization link, see authorizationData.

", "smithy.api#required": {} } }, "authorizationData": { "target": "com.amazonaws.agentregistrycontrol#AuthorizationData", "traits": { "smithy.api#documentation": "

The authorization that a GitHub user must complete before the record's synchronization starts. Present only in this response, and only while the status is CREATE_PENDING_AUTH. If the status is CREATE_PENDING_AUTH but this member is absent, call UpdateRegistryRecord with triggerSynchronization to get a new authorization link.

" } } }, "traits": { "smithy.api#documentation": "

Response structure for creating a registry record

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#CreateRegistryRequest": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryName", "traits": { "smithy.api#documentation": "

The name of the registry

", "smithy.api#required": {} } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

The description of the registry

" } }, "encryptionConfiguration": { "target": "com.amazonaws.agentregistrycontrol#EncryptionConfiguration", "traits": { "smithy.api#documentation": "

The optional server-side encryption configuration for the registry. When you provide this field, the specified customer-managed Amazon Web Services KMS key encrypts the registry's content. Omit this field to use an Amazon Web Services-owned encryption key. You cannot change the encryption configuration after registry creation.

" } }, "discoveryConfiguration": { "target": "com.amazonaws.agentregistrycontrol#DiscoveryConfiguration", "traits": { "smithy.api#documentation": "

Discovery configuration for the registry

" } }, "clientToken": { "target": "com.amazonaws.agentregistrycontrol#ClientToken", "traits": { "smithy.api#documentation": "

A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the service ignores the request, but does not return an error.

", "smithy.api#idempotencyToken": {} } }, "tags": { "target": "com.amazonaws.agentregistrycontrol#TagsMap", "traits": { "smithy.api#documentation": "

Tags to associate with the registry

" } }, "approvalConfiguration": { "target": "com.amazonaws.agentregistrycontrol#ApprovalConfiguration", "traits": { "smithy.api#documentation": "

Approval configuration for registry records

" } }, "customMetadataSchemaConfiguration": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaConfiguration", "traits": { "smithy.api#documentation": "

The optional custom metadata schema configuration for the registry. When provided, registry records can carry structured metadata validated against this schema.

" } }, "autoDetectionConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AutoDetectionConfiguration", "traits": { "smithy.api#documentation": "

The optional auto-detection configuration for the registry. When provided, the registry is automatically populated with resources discovered according to the configuration. Omit this field for registries whose records are managed exclusively through the Agent Registry Control API.

" } } }, "traits": { "smithy.api#documentation": "

Request structure for creating a registry

", "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#CreateRegistryResponse": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The ARN of the created registry

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for creating a registry

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#CreatorAccountId": { "type": "string", "traits": { "smithy.api#length": { "min": 12, "max": 12 }, "smithy.api#pattern": "^[0-9]{12}$" } }, "com.amazonaws.agentregistrycontrol#CredentialProviderArn": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^arn:aws(-[^:]+)?:bedrock-agentcore:[a-z0-9-]+:[0-9]{12}:.*$" } }, "com.amazonaws.agentregistrycontrol#CustomClaimValidationType": { "type": "structure", "members": { "inboundTokenClaimName": { "target": "com.amazonaws.agentregistrycontrol#InboundTokenClaimNameType", "traits": { "smithy.api#documentation": "

The name of the claim in the inbound token to validate.

", "smithy.api#required": {} } }, "inboundTokenClaimValueType": { "target": "com.amazonaws.agentregistrycontrol#InboundTokenClaimValueType", "traits": { "smithy.api#documentation": "

The value type of the claim in the inbound token, either a string or an array of strings.

", "smithy.api#required": {} } }, "authorizingClaimMatchValue": { "target": "com.amazonaws.agentregistrycontrol#AuthorizingClaimMatchValueType", "traits": { "smithy.api#documentation": "

The value and match operator used to authorize the claim.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A validation rule applied to a single claim of an inbound JWT.

" } }, "com.amazonaws.agentregistrycontrol#CustomClaimValidationsType": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#CustomClaimValidationType" }, "traits": { "smithy.api#documentation": "

The list of custom claim validations applied to an inbound JWT.

", "smithy.api#length": { "min": 1 } } }, "com.amazonaws.agentregistrycontrol#CustomDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The custom descriptor content, serialized as descriptor payload data.

" } } }, "traits": { "smithy.api#documentation": "

Custom descriptor for user-defined content

" } }, "com.amazonaws.agentregistrycontrol#CustomJWTAuthorizerConfiguration": { "type": "structure", "members": { "discoveryUrl": { "target": "com.amazonaws.agentregistrycontrol#DiscoveryUrl", "traits": { "smithy.api#documentation": "

The OpenID Connect discovery or OAuth 2.0 authorization server metadata URL used to retrieve the identity provider's metadata and signing keys.

", "smithy.api#required": {} } }, "allowedAudience": { "target": "com.amazonaws.agentregistrycontrol#AllowedAudienceList", "traits": { "smithy.api#documentation": "

The audience values accepted during JWT validation. A token is rejected if none of its audience claims match.

" } }, "allowedClients": { "target": "com.amazonaws.agentregistrycontrol#AllowedClientsList", "traits": { "smithy.api#documentation": "

The client identifiers accepted during JWT validation. A token is rejected if it was not issued to one of these clients.

" } }, "allowedScopes": { "target": "com.amazonaws.agentregistrycontrol#AllowedScopesType", "traits": { "smithy.api#documentation": "

The scopes accepted during JWT validation. A token is rejected if it does not carry one of these scopes.

" } }, "customClaims": { "target": "com.amazonaws.agentregistrycontrol#CustomClaimValidationsType", "traits": { "smithy.api#documentation": "

Additional custom claim validations applied to the inbound JWT.

" } }, "privateEndpoint": { "target": "com.amazonaws.agentregistrycontrol#PrivateEndpoint", "traits": { "smithy.api#documentation": "

The private endpoint used to reach the identity provider's discovery URL over a private network path.

" } }, "privateEndpointOverrides": { "target": "com.amazonaws.agentregistrycontrol#PrivateEndpointOverrides", "traits": { "smithy.api#documentation": "

Per-domain private endpoint overrides that route specific identity provider domains through distinct private endpoints.

" } } }, "traits": { "smithy.api#documentation": "

Configuration for a custom JWT authorizer that validates inbound bearer tokens against an OpenID Connect identity provider.

" } }, "com.amazonaws.agentregistrycontrol#CustomMetadataDocument": { "type": "document", "traits": { "smithy.api#documentation": "Free-form JSON document representing custom metadata on a registry record.\nValues may be strings or booleans (native JSON types). Key/value constraints enforced in service code.", "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaComplianceStatus": { "type": "enum", "members": { "COMPLIANT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "COMPLIANT" } }, "NON_COMPLIANT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NON_COMPLIANT" } } }, "traits": { "smithy.api#documentation": "

Indicates whether a registry record's custom metadata conforms to the registry's current schema. COMPLIANT means all required fields are present and all values match their declared types. NON_COMPLIANT means the metadata does not satisfy the current schema, for example because the schema was updated after the record was last modified.

" } }, "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaConfiguration": { "type": "structure", "members": { "defaultSchema": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaDefinition", "traits": { "smithy.api#documentation": "

A JSON Schema with the common attributes: fields that records of every record type can carry.

" } }, "recordTypeSchemaOverrides": { "target": "com.amazonaws.agentregistrycontrol#RecordTypeSchemaOverrideList", "traits": { "smithy.api#documentation": "

The fields for individual record types. Records of a record type can carry the common attributes defined in defaultSchema plus that record type's fields.

" } } }, "traits": { "smithy.api#documentation": "

The custom metadata fields that records in the registry can carry. defaultSchema defines the common attributes for every record type, and recordTypeSchemaOverrides adds fields for individual record types.

", "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaDefinition": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 16384 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#CustomParameterMap": { "type": "map", "key": { "target": "smithy.api#String" }, "value": { "target": "smithy.api#String" }, "traits": { "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#DataSchemaVersion": { "type": "string", "traits": { "smithy.api#documentation": "

Version of the descriptor type schema

", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#DateTimestamp": { "type": "timestamp", "traits": { "smithy.api#documentation": "

Timestamp in ISO 8601 date-time format

", "smithy.api#timestampFormat": "date-time" } }, "com.amazonaws.agentregistrycontrol#DeleteRegistry": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistryRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistryResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Deletes a registry. Deletion is asynchronous: the registry transitions to the DELETING status and is removed along with its registry records.

", "smithy.api#http": { "code": 202, "method": "DELETE", "uri": "/registries/{registryId}" }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#DeleteRegistryRecord": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistryRecordRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistryRecordResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Deletes a registry record

", "smithy.api#http": { "method": "DELETE", "uri": "/registries/{registryId}/records/{recordId}", "code": 200 }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#DeleteRegistryRecordRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry containing the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry record to delete (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#DeleteRegistryRecordResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#documentation": "

Response structure for deleting a registry record

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#DeleteRegistryRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry to delete (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {}, "smithy.api#suppress": [ "MemberShouldReferenceResource" ] } } }, "traits": { "smithy.api#documentation": "

Request structure for deleting a registry

", "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#DeleteRegistryResponse": { "type": "structure", "members": { "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryStatus", "traits": { "smithy.api#documentation": "

Current status of the registry, set to DELETING when deletion is initiated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for deleting a registry

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#Description": { "type": "string", "traits": { "smithy.api#documentation": "

Description of the Resource

", "smithy.api#length": { "min": 1, "max": 4096 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#DescriptorData": { "type": "string", "traits": { "smithy.api#documentation": "

Descriptor payload data

", "smithy.api#length": { "min": 1, "max": 102400 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#DescriptorSource": { "type": "structure", "members": { "fromUrl": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSourceFromUrl", "traits": { "smithy.api#documentation": "

URL-based descriptor source, populated when descriptor content is synchronized from a URL.

" } } }, "traits": { "smithy.api#documentation": "

The source configuration that defines where descriptor content is retrieved from.

" } }, "com.amazonaws.agentregistrycontrol#DescriptorSourceFromUrl": { "type": "structure", "members": { "url": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSourceUrl", "traits": { "smithy.api#documentation": "

The URL from which the descriptor content is retrieved. For an agent skill source, specify an s3:// URL of an object in a bucket in the same Amazon Web Services Region as the registry. For a GitHub skill source, specify a GitHub folder URL in the form https://host/owner/repo/tree/branch-or-tag/path. Other descriptor sources use https:// URLs.

", "smithy.api#required": {} } }, "credentialProviderConfigurations": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderConfigurationList", "traits": { "smithy.api#documentation": "

The credential providers used to authenticate when fetching descriptor content from the source URL.

" } } }, "traits": { "smithy.api#documentation": "

URL-based descriptor source configuration, with credential provider configurations for authenticated URL retrieval.

" } }, "com.amazonaws.agentregistrycontrol#DescriptorSourceUrl": { "type": "string", "traits": { "smithy.api#documentation": "

The URL of a descriptor source, up to 2,048 characters, that starts with https:// or s3://. The registry accepts s3:// URLs only for agent skill sources, and its discovery operations never return them.

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^(https|s3)://.*$" } }, "com.amazonaws.agentregistrycontrol#Descriptors": { "type": "structure", "members": { "mcpServer": { "target": "com.amazonaws.agentregistrycontrol#McpServerDescriptor", "traits": { "smithy.api#documentation": "

The MCP server descriptor, populated when the record type is MCP.

" } }, "a2aAgentCard": { "target": "com.amazonaws.agentregistrycontrol#A2aAgentCardDescriptor", "traits": { "smithy.api#documentation": "

The A2A agent card descriptor, populated when the record type is AGENT.

" } }, "agentSkillsDefinition": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsDefinitionDescriptor", "traits": { "smithy.api#documentation": "

The agent skills definition descriptor, populated when the record type is SKILL.

" } }, "custom": { "target": "com.amazonaws.agentregistrycontrol#CustomDescriptor", "traits": { "smithy.api#documentation": "

The custom descriptor, populated when the record type is CUSTOM.

" } }, "http": { "target": "com.amazonaws.agentregistrycontrol#HttpDescriptor", "traits": { "smithy.api#documentation": "

The HTTP descriptor, populated for records detected from an HTTP protocol source.

" } }, "agui": { "target": "com.amazonaws.agentregistrycontrol#AgUiDescriptor", "traits": { "smithy.api#documentation": "

The AG-UI descriptor, populated for records detected from an AG-UI protocol source.

" } } }, "traits": { "smithy.api#documentation": "

The typed set of descriptors for a registry record. Exactly one descriptor field is populated based on the record type.

" } }, "com.amazonaws.agentregistrycontrol#DiscoveryConfiguration": { "type": "structure", "members": { "authorizerConfiguration": { "target": "com.amazonaws.agentregistrycontrol#AuthorizerConfiguration", "traits": { "smithy.api#documentation": "

The authorizer configuration for the registry. Required when authorizerType is CUSTOM_JWT.

" } }, "authorizerType": { "target": "com.amazonaws.agentregistrycontrol#RegistryAuthorizerType", "traits": { "smithy.api#documentation": "

The type of authorizer that controls how consumers access the registry's search and MCP invoke operations.

" } } }, "traits": { "smithy.api#documentation": "

Discovery configuration for the registry. Controls how consumers are authorized to search the registry and invoke its MCP endpoint.

" } }, "com.amazonaws.agentregistrycontrol#DiscoveryUrl": { "type": "string", "traits": { "smithy.api#documentation": "

The OpenID Connect discovery or OAuth 2.0 authorization server metadata URL used to retrieve the identity provider's metadata and signing keys. The URL contains /.well-known/openid-configuration or /.well-known/oauth-authorization-server, respectively.

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^[^\\s?#]+/\\.well-known/(openid-configuration|oauth-authorization-server)(/[^\\s?#]+)?$" } }, "com.amazonaws.agentregistrycontrol#EncryptionConfiguration": { "type": "structure", "members": { "kmsKeyArn": { "target": "com.amazonaws.agentregistrycontrol#KmsKeyArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the customer-managed Amazon Web Services KMS key used to encrypt the registry's content. The key must be a symmetric encryption key in the same Amazon Web Services account and Region as the registry.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The server-side encryption configuration for a registry. Specifies a customer-managed Amazon Web Services KMS key used to encrypt the registry's content.

" } }, "com.amazonaws.agentregistrycontrol#EndpointIpAddressType": { "type": "enum", "members": { "IPV4": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IPV4" } }, "IPV6": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IPV6" } } }, "traits": { "smithy.api#documentation": "

The IP address type used by a private endpoint.

" } }, "com.amazonaws.agentregistrycontrol#FilterValue": { "type": "string", "traits": { "smithy.api#documentation": "

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.

", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#FilterValues": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#FilterValue" }, "traits": { "smithy.api#documentation": "

The values supplied for a single filter.

", "smithy.api#length": { "min": 1, "max": 1 } } }, "com.amazonaws.agentregistrycontrol#GetRegistry": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#GetRegistryRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#GetRegistryResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Gets a registry by identifier (ARN or ID)

", "smithy.api#http": { "code": 200, "method": "GET", "uri": "/registries/{registryId}" }, "smithy.api#readonly": {}, "smithy.test#smokeTests": [ { "id": "GetRegistryFailure", "params": { "registryId": "000000000000" }, "expect": { "failure": { "errorId": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" } }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ], "smithy.waiters#waitable": { "RegistryReady": { "minDelay": 30, "acceptors": [ { "state": "success", "matcher": { "output": { "path": "status", "expected": "READY", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "CREATE_FAILED", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "UPDATE_FAILED", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "DELETE_FAILED", "comparator": "stringEquals" } } } ] } } } }, "com.amazonaws.agentregistrycontrol#GetRegistryRecord": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#GetRegistryRecordRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#GetRegistryRecordResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Retrieves the details of a registry record. The response describes the record's latest revision, including a revision that isn't approved yet. For a skill record, the operation also returns the skill package in artifact and the source that the registry last synchronized the skill from in synchronizedSource.

", "smithy.api#http": { "method": "GET", "uri": "/registries/{registryId}/records/{recordId}", "code": 200 }, "smithy.api#readonly": {}, "smithy.waiters#waitable": { "RegistryRecordApproved": { "minDelay": 30, "acceptors": [ { "state": "success", "matcher": { "output": { "path": "status", "expected": "APPROVED", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "REJECTED", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "CREATE_FAILED", "comparator": "stringEquals" } } }, { "state": "failure", "matcher": { "output": { "path": "status", "expected": "UPDATE_FAILED", "comparator": "stringEquals" } } } ] } } } }, "com.amazonaws.agentregistrycontrol#GetRegistryRecordRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry containing the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry record to retrieve (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#GetRegistryRecordResponse": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the parent registry that owns the record.

", "smithy.api#required": {} } }, "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the registry record.

", "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordId", "traits": { "smithy.api#documentation": "

The unique identifier of the registry record.

", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordName", "traits": { "smithy.api#documentation": "

The name of the registry record. Names are unique within a registry.

", "smithy.api#required": {} } }, "displayName": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName", "traits": { "smithy.api#documentation": "

The human-readable display name of the registry record.

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

A description of the registry record.

" } }, "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The type of the registry record, such as MCP, AGENT, SKILL, or CUSTOM.

", "smithy.api#required": {} } }, "descriptors": { "target": "com.amazonaws.agentregistrycontrol#Descriptors", "traits": { "smithy.api#documentation": "

The typed descriptors that define the content of the registry record. For a skill record with a skill package or a synchronized source, skillMd.data contains the SKILL.md that the registry took from the package or the source.

" } }, "recordVersion": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordVersion", "traits": { "smithy.api#documentation": "

The version identifier of the registry record.

" } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The lifecycle status of the registry record.

", "smithy.api#required": {} } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was created.

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was last updated.

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the current status. Typically populated when the status indicates a failure state.

" } }, "provenance": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceList", "traits": { "smithy.api#documentation": "

The provenance lineage entries for the registry record. Populated for records created by auto-detection; each entry identifies the upstream source that the record was detected from.

" } }, "createdByAutoDetection": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether the registry record was created by auto-detection. true indicates the record was automatically created by the service based on the registry's auto-detection configuration; false indicates the record was created through a control-plane API call.

" } }, "createdBy": { "target": "com.amazonaws.agentregistrycontrol#CreatorAccountId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Web Services account that created the registry record.

" } }, "customMetadata": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataDocument", "traits": { "smithy.api#documentation": "

The custom metadata attached to this registry record. Values are strings (maximum 128 characters) or booleans.

" } }, "customMetadataSchemaComplianceStatus": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaComplianceStatus", "traits": { "smithy.api#documentation": "

Indicates whether this record's custom metadata conforms to the registry's current schema. This status is computed at read time against the latest schema.

" } }, "artifact": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArtifactDownload", "traits": { "smithy.api#documentation": "

The skill package of the record's latest revision, including a revision in DRAFT or PENDING_APPROVAL status, as a download URL and a SHA-256 checksum. While an update of the record is in progress or after it fails, this is the last package that passed validation, unless the update switches between an uploaded package and a synchronized one: then it is absent until the update succeeds. Absent while the record is being created or after its creation fails, and when the record has no package, for example when its content is inline or it synchronizes only SKILL.md.

" } }, "synchronizedSource": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordSynchronizedSource", "traits": { "smithy.api#documentation": "

The source that the registry last synchronized the record's skill content from, including when the registry read the source and which version it read. Absent until the first successful synchronization, and after an update replaces the synchronized content, for example with an uploaded package. A failed synchronization leaves this member unchanged. After you change the source, this member shows the previous source until the registry successfully synchronizes from the new source.

" } } }, "traits": { "smithy.api#documentation": "

Response structure for retrieving a registry record

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#GetRegistryRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry to retrieve (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {}, "smithy.api#suppress": [ "MemberShouldReferenceResource" ] } } }, "traits": { "smithy.api#documentation": "

Request structure for getting a registry

", "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#GetRegistryResponse": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryName", "traits": { "smithy.api#documentation": "

The name of the registry

", "smithy.api#required": {} } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

The description of the registry

" } }, "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryId", "traits": { "smithy.api#documentation": "

The unique identifier of the registry

", "smithy.api#required": {} } }, "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The ARN of the registry

", "smithy.api#required": {} } }, "discoveryConfiguration": { "target": "com.amazonaws.agentregistrycontrol#DiscoveryConfiguration", "traits": { "smithy.api#documentation": "

Discovery configuration for the registry

" } }, "encryptionConfiguration": { "target": "com.amazonaws.agentregistrycontrol#EncryptionConfiguration", "traits": { "smithy.api#documentation": "

The server-side encryption configuration for the registry. Appears only when a customer-managed Amazon Web Services KMS key encrypts the registry.

" } }, "approvalConfiguration": { "target": "com.amazonaws.agentregistrycontrol#ApprovalConfiguration", "traits": { "smithy.api#documentation": "

Approval configuration for registry records

" } }, "customMetadataSchemaConfiguration": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaConfiguration", "traits": { "smithy.api#documentation": "

The custom metadata schema configuration for this registry, if one has been defined.

" } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryStatus", "traits": { "smithy.api#documentation": "

Current status of the registry

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the current status. Typically populated when the status indicates a failure state.

" } }, "autoDetection": { "target": "com.amazonaws.agentregistrycontrol#AutoDetection", "traits": { "smithy.api#documentation": "

The registry's auto-detection properties, including the requested configuration and the current detection status. Present only when auto-detection was configured for the registry.

" } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was created

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was last updated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for getting a registry

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#GitCommitId": { "type": "string", "traits": { "smithy.api#documentation": "

The full hash of a Git commit, as 40 lowercase hexadecimal characters, or 64 in a repository that uses SHA-256.

", "smithy.api#length": { "min": 40, "max": 64 }, "smithy.api#pattern": "^([0-9a-f]{40}|[0-9a-f]{64})$" } }, "com.amazonaws.agentregistrycontrol#GitHubSynchronizedSource": { "type": "structure", "members": { "url": { "target": "com.amazonaws.agentregistrycontrol#SynchronizedSourceUrl", "traits": { "smithy.api#documentation": "

The source URL that the registry read.

", "smithy.api#required": {} } }, "synchronizedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry read the source.

", "smithy.api#required": {} } }, "commitId": { "target": "com.amazonaws.agentregistrycontrol#GitCommitId", "traits": { "smithy.api#documentation": "

The commit that the source's branch or tag pointed to when the registry read it.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A GitHub source that a skill record's content was synchronized from, and the commit that the registry read.

" } }, "com.amazonaws.agentregistrycontrol#HttpDescriptor": { "type": "structure", "members": { "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource" } }, "traits": { "smithy.api#documentation": "

A registry record descriptor for the HTTP protocol. This descriptor is source-only: its content is synchronized from the configured source URL rather than supplied inline.

" } }, "com.amazonaws.agentregistrycontrol#IamRoleArn": { "type": "string", "traits": { "smithy.api#length": { "min": 20, "max": 2048 }, "smithy.api#pattern": "^arn:aws(-[^:]+)?:iam::[0-9]{12}:role/.+$" } }, "com.amazonaws.agentregistrycontrol#IamSigningRegion": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 64 }, "smithy.api#pattern": "^[a-z0-9-]+$" } }, "com.amazonaws.agentregistrycontrol#IamSigningServiceName": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 128 }, "smithy.api#pattern": "^[a-zA-Z0-9_-]+$" } }, "com.amazonaws.agentregistrycontrol#InboundTokenClaimNameType": { "type": "string", "traits": { "smithy.api#documentation": "

The name of a claim in an inbound JWT.

", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[A-Za-z0-9_.-:]+$" } }, "com.amazonaws.agentregistrycontrol#InboundTokenClaimValueType": { "type": "enum", "members": { "STRING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STRING" } }, "STRING_ARRAY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "STRING_ARRAY" } } }, "traits": { "smithy.api#documentation": "

The value type of a claim in an inbound JWT.

" } }, "com.amazonaws.agentregistrycontrol#InternalServerException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The request failed due to an unexpected internal error; the caller may retry.

", "smithy.api#error": "server", "smithy.api#httpError": 500 } }, "com.amazonaws.agentregistrycontrol#KmsKeyArn": { "type": "string", "traits": { "smithy.api#documentation": "

A KMS key ARN

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^arn:aws(|-cn|-us-gov):kms:[a-zA-Z0-9-]*:[0-9]{12}:key/[a-zA-Z0-9-]{36}$" } }, "com.amazonaws.agentregistrycontrol#ListRegistries": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#ListRegistriesRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#ListRegistriesResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Lists the registries in the caller's account and Region, with optional filtering by status and discovery authorizer type

", "smithy.api#http": { "code": 200, "method": "POST", "uri": "/registries-list" }, "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "registries" }, "smithy.api#readonly": {}, "smithy.test#smokeTests": [ { "id": "ListRegistriesSuccess", "params": {}, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.agentregistrycontrol#ListRegistriesRequest": { "type": "structure", "members": { "maxResults": { "target": "com.amazonaws.agentregistrycontrol#MaxResults", "traits": { "smithy.api#documentation": "

Maximum number of results to return

" } }, "nextToken": { "target": "com.amazonaws.agentregistrycontrol#NextToken", "traits": { "smithy.api#documentation": "

Token for pagination

" } }, "filters": { "target": "com.amazonaws.agentregistrycontrol#RegistryFilterList", "traits": { "smithy.api#documentation": "

Filters to apply to the registry list

" } } }, "traits": { "smithy.api#documentation": "

Request structure for listing registries

", "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#ListRegistriesResponse": { "type": "structure", "members": { "registries": { "target": "com.amazonaws.agentregistrycontrol#RegistrySummaryList", "traits": { "smithy.api#documentation": "

List of registry summaries

", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.agentregistrycontrol#NextToken", "traits": { "smithy.api#documentation": "

Token for next page of results

" } } }, "traits": { "smithy.api#documentation": "

Response structure for listing registries

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#ListRegistryRecords": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#ListRegistryRecordsRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#ListRegistryRecordsResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Lists the registry records within a registry, with optional filtering by name, status, and record type

", "smithy.api#http": { "code": 200, "method": "POST", "uri": "/registries/{registryId}/records-list" }, "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "registryRecords" }, "smithy.api#readonly": {} } }, "com.amazonaws.agentregistrycontrol#ListRegistryRecordsRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry to list records from (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "maxResults": { "target": "com.amazonaws.agentregistrycontrol#MaxResults", "traits": { "smithy.api#documentation": "

Maximum number of records to return

" } }, "nextToken": { "target": "com.amazonaws.agentregistrycontrol#NextToken", "traits": { "smithy.api#documentation": "

Token for pagination

" } }, "filters": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordFilterList", "traits": { "smithy.api#documentation": "

Filters to apply to the registry record list

" } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#ListRegistryRecordsResponse": { "type": "structure", "members": { "registryRecords": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordSummaryList", "traits": { "smithy.api#documentation": "

List of registry record summaries

", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.agentregistrycontrol#NextToken", "traits": { "smithy.api#documentation": "

Token for next page of results

" } } }, "traits": { "smithy.api#documentation": "

Response structure for listing registry records

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#ListTagsForResource": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#ListTagsForResourceRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#ListTagsForResourceResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Lists the tags associated with the specified Amazon Web Services Agent Registry resource. Returns the current tag key-value pairs on the resource.

", "smithy.api#http": { "code": 200, "method": "GET", "uri": "/tags/{resourceArn+}" }, "smithy.api#readonly": {} } }, "com.amazonaws.agentregistrycontrol#ListTagsForResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.agentregistrycontrol#ResourceArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource to list tags for. Supported resources include registries and registry records.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#ListTagsForResourceResponse": { "type": "structure", "members": { "tags": { "target": "com.amazonaws.agentregistrycontrol#ResourceTagsMap", "traits": { "smithy.api#documentation": "

The tags currently associated with the resource, as a map of tag keys to tag values.

" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#ManagedVpcResource": { "type": "structure", "members": { "vpcIdentifier": { "target": "com.amazonaws.agentregistrycontrol#VpcIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the VPC in which the private endpoint is provisioned.

", "smithy.api#required": {} } }, "subnetIds": { "target": "com.amazonaws.agentregistrycontrol#SubnetIds", "traits": { "smithy.api#documentation": "

The identifiers of the subnets in which the private endpoint network interfaces are placed.

", "smithy.api#required": {} } }, "endpointIpAddressType": { "target": "com.amazonaws.agentregistrycontrol#EndpointIpAddressType", "traits": { "smithy.api#documentation": "

The IP address type used by the private endpoint, either IPV4 or IPV6.

", "smithy.api#required": {} } }, "securityGroupIds": { "target": "com.amazonaws.agentregistrycontrol#SecurityGroupIds", "traits": { "smithy.api#documentation": "

The identifiers of the security groups associated with the private endpoint network interfaces.

" } }, "tags": { "target": "com.amazonaws.agentregistrycontrol#TagsMap", "traits": { "smithy.api#documentation": "

The tags applied to the service-managed VPC resource.

" } }, "routingDomain": { "target": "com.amazonaws.agentregistrycontrol#RoutingDomain", "traits": { "smithy.api#documentation": "

The routing domain used to resolve traffic through the private endpoint.

" } } }, "traits": { "smithy.api#documentation": "

A service-managed private endpoint provisioned within a customer VPC.

" } }, "com.amazonaws.agentregistrycontrol#MatchValueString": { "type": "string", "traits": { "smithy.api#documentation": "

A single value used to match a claim during JWT validation.

", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[A-Za-z0-9_.:/-]+$" } }, "com.amazonaws.agentregistrycontrol#MatchValueStringList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#MatchValueString" }, "traits": { "smithy.api#documentation": "

A list of values used to match a claim during JWT validation.

", "smithy.api#length": { "min": 1 } } }, "com.amazonaws.agentregistrycontrol#MaxResults": { "type": "integer", "traits": { "smithy.api#documentation": "

Maximum number of items to be listed

", "smithy.api#range": { "min": 1, "max": 100 } } }, "com.amazonaws.agentregistrycontrol#McpServerAdditionalData": { "type": "structure", "members": { "tools": { "target": "com.amazonaws.agentregistrycontrol#McpToolsDescriptor", "traits": { "smithy.api#documentation": "

The MCP tools descriptor that defines the tools exposed by the MCP server.

" } } }, "traits": { "smithy.api#documentation": "

Additional data for an MCP server descriptor

" } }, "com.amazonaws.agentregistrycontrol#McpServerDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The MCP server descriptor content, serialized as descriptor payload data.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The schema version of the descriptor payload.

" } }, "additionalData": { "target": "com.amazonaws.agentregistrycontrol#McpServerAdditionalData", "traits": { "smithy.api#documentation": "

Additional data associated with the MCP server descriptor, such as tool definitions.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource", "traits": { "smithy.api#documentation": "

The optional source configuration used to synchronize the MCP server descriptor content.

" } } }, "traits": { "smithy.api#documentation": "

Descriptor that defines the content of an MCP (Model Context Protocol) server registry record, including the server definition and its tool definitions. The content is validated against the MCP protocol schema.

" } }, "com.amazonaws.agentregistrycontrol#McpToolsDescriptor": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The MCP tools descriptor content, serialized as descriptor payload data.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The schema version of the descriptor payload.

" } } }, "traits": { "smithy.api#documentation": "

MCP tools descriptor containing tool definitions

" } }, "com.amazonaws.agentregistrycontrol#NextToken": { "type": "string", "traits": { "smithy.api#documentation": "

Opaque continuation token of previous paginated response

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^\\S*$" } }, "com.amazonaws.agentregistrycontrol#NonBlankString": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^[\\s\\S]+$" } }, "com.amazonaws.agentregistrycontrol#OAuth2AuthorizationData": { "type": "structure", "members": { "authorizationUrl": { "target": "com.amazonaws.agentregistrycontrol#OAuthAuthorizationUrl", "traits": { "smithy.api#documentation": "

The URL that the user opens to approve access. The link is valid for up to 10 minutes. Treat it as sensitive and give it only to the user who approves access.

", "smithy.api#required": {} } }, "userId": { "target": "com.amazonaws.agentregistrycontrol#OAuthUserId", "traits": { "smithy.api#documentation": "

The AgentCore Identity user ID that the authorization is for. Store it with your signed-in user and pass it as userIdentifier.userId when your application calls CompleteResourceTokenAuth.

" } }, "authorizationAttemptId": { "target": "com.amazonaws.agentregistrycontrol#AuthorizationAttemptId", "traits": { "smithy.api#documentation": "

The identifier of this authorization attempt.

" } }, "expiresAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the authorization link expires, 10 minutes after the authorization started. A request that joins an authorization in progress gets less time, and the link might stop working shortly before this time.

" } } }, "traits": { "smithy.api#documentation": "

An OAuth 2.0 authorization that waits for a user's approval. The user opens authorizationUrl and approves access on GitHub. Amazon Bedrock AgentCore Identity then redirects the browser to the source's returnUrl. There, your application completes the authorization by calling the AgentCore Identity CompleteResourceTokenAuth operation with userId. If the source has no returnUrl, the user returns to the Amazon Web Services Agent Registry console, which completes the authorization. After the authorization completes, the registry synchronizes the record without another request. If the user doesn't approve access before expiresAt, the record moves to CREATE_FAILED or UPDATE_FAILED. To start again, call UpdateRegistryRecord with triggerSynchronization.

" } }, "com.amazonaws.agentregistrycontrol#OAuthAuthorizationUrl": { "type": "string", "traits": { "smithy.api#documentation": "

A URL that a user opens to approve an OAuth 2.0 authorization. It carries the authorization session, so treat it as sensitive.

", "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#OAuthReturnUrl": { "type": "string", "traits": { "smithy.api#documentation": "

A URL of up to 2,048 characters that uses the https scheme, in lowercase, and a public domain name rather than an IP address. The URL can include a query string, but not a user name, password, or fragment. Only localhost, 127.0.0.1, and [::1] can also use http.

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^\\w+:(\\/?\\/?)[^\\s]+$" } }, "com.amazonaws.agentregistrycontrol#OAuthUserId": { "type": "string", "traits": { "smithy.api#documentation": "

The AgentCore Identity user ID that an OAuth 2.0 authorization, and the tokens that it yields, are bound to.

", "smithy.api#length": { "min": 1, "max": 128 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#PresignedDownloadUrl": { "type": "string", "traits": { "smithy.api#documentation": "

A presigned URL that downloads a stored file until the URL expires. It's a bearer credential. Anyone who has the URL can download the file, so don't log, store, or share it.

", "smithy.api#length": { "min": 1, "max": 4096 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#PrivateEndpoint": { "type": "union", "members": { "selfManagedLatticeResource": { "target": "com.amazonaws.agentregistrycontrol#SelfManagedLatticeResource", "traits": { "smithy.api#documentation": "

A private endpoint backed by a self-managed VPC Lattice resource configuration.

" } }, "managedVpcResource": { "target": "com.amazonaws.agentregistrycontrol#ManagedVpcResource", "traits": { "smithy.api#documentation": "

A private endpoint backed by a service-managed VPC resource.

" } } }, "traits": { "smithy.api#documentation": "

A private network endpoint used to reach a resource over a private path. Exactly one member is set.

" } }, "com.amazonaws.agentregistrycontrol#PrivateEndpointOverride": { "type": "structure", "members": { "domain": { "target": "com.amazonaws.agentregistrycontrol#PrivateEndpointOverrideDomain", "traits": { "smithy.api#documentation": "

The domain name to which this private endpoint override applies.

", "smithy.api#required": {} } }, "privateEndpoint": { "target": "com.amazonaws.agentregistrycontrol#PrivateEndpoint", "traits": { "smithy.api#documentation": "

The private endpoint used to reach the specified domain.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A mapping of a domain to the private endpoint used to reach it.

" } }, "com.amazonaws.agentregistrycontrol#PrivateEndpointOverrideDomain": { "type": "string", "traits": { "smithy.api#documentation": "

A domain name for which a specific private endpoint override applies.

", "smithy.api#length": { "min": 1, "max": 253 } } }, "com.amazonaws.agentregistrycontrol#PrivateEndpointOverrides": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#PrivateEndpointOverride" }, "traits": { "smithy.api#documentation": "

The list of per-domain private endpoint overrides.

", "smithy.api#length": { "max": 5 } } }, "com.amazonaws.agentregistrycontrol#Provenance": { "type": "structure", "members": { "relation": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceRelation", "traits": { "smithy.api#documentation": "

The relationship between the registry record and its upstream source. DETECTED_FROM indicates that the record was auto-detected from the source resource.

", "smithy.api#required": {} } }, "sourceId": { "target": "com.amazonaws.agentregistrycontrol#SourceId", "traits": { "smithy.api#documentation": "

The identifier of the upstream source that the registry record was detected from.

", "smithy.api#required": {} } }, "sourceType": { "target": "com.amazonaws.agentregistrycontrol#SourceType", "traits": { "smithy.api#documentation": "

The type of the upstream source that the registry record was detected from.

" } }, "sourceDetails": { "target": "com.amazonaws.agentregistrycontrol#SourceDetails", "traits": { "smithy.api#documentation": "

Additional details about the upstream source that the registry record was detected from, such as the AgentCore Gateway or Runtime configuration. The populated member corresponds to the source type.

" } } }, "traits": { "smithy.api#documentation": "

A provenance entry that describes the lineage of a registry record. Records that were auto-detected by Amazon Web Services Agent Registry carry a provenance entry that links the record back to its upstream source.

" } }, "com.amazonaws.agentregistrycontrol#ProvenanceList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#Provenance" }, "traits": { "smithy.api#length": { "max": 1 } } }, "com.amazonaws.agentregistrycontrol#ProvenanceRelation": { "type": "enum", "members": { "DETECTED_FROM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DETECTED_FROM" } } } }, "com.amazonaws.agentregistrycontrol#ProvenanceSummary": { "type": "structure", "members": { "relation": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceRelation", "traits": { "smithy.api#documentation": "

The relationship between the registry record and its upstream source. DETECTED_FROM indicates that the record was auto-detected from the source resource.

", "smithy.api#required": {} } }, "sourceId": { "target": "com.amazonaws.agentregistrycontrol#SourceId", "traits": { "smithy.api#documentation": "

The identifier of the upstream source that the registry record was detected from.

", "smithy.api#required": {} } }, "sourceType": { "target": "com.amazonaws.agentregistrycontrol#SourceType", "traits": { "smithy.api#documentation": "

The type of the upstream source that the registry record was detected from.

" } } }, "traits": { "smithy.api#documentation": "

A condensed provenance entry surfaced in list results. Contains the source identity of a lineage entry without the source details returned by GetRegistryRecord.

" } }, "com.amazonaws.agentregistrycontrol#ProvenanceSummaryList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceSummary" }, "traits": { "smithy.api#length": { "max": 1 } } }, "com.amazonaws.agentregistrycontrol#RecordIdentifier": { "type": "string", "traits": { "smithy.api#documentation": "

Record identifier that accepts either ARN or ID format

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/)?[a-zA-Z0-9]{12}$" } }, "com.amazonaws.agentregistrycontrol#RecordType": { "type": "enum", "members": { "MCP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "MCP" } }, "AGENT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AGENT" } }, "CUSTOM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CUSTOM" } }, "SKILL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SKILL" } }, "GATEWAY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "GATEWAY" } } }, "traits": { "smithy.api#documentation": "

Record type enum for registry record classification

" } }, "com.amazonaws.agentregistrycontrol#RecordTypeSchemaOverride": { "type": "structure", "members": { "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The record type these fields apply to.

", "smithy.api#required": {} } }, "schema": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaDefinition", "traits": { "smithy.api#documentation": "

A JSON Schema with the fields for this record type.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The custom metadata fields for one record type, in addition to the common attributes defined in defaultSchema.

" } }, "com.amazonaws.agentregistrycontrol#RecordTypeSchemaOverrideList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RecordTypeSchemaOverride" }, "traits": { "smithy.api#length": { "max": 10 } } }, "com.amazonaws.agentregistrycontrol#RegistryArn": { "type": "string", "traits": { "aws.api#arnReference": { "type": "AWS::AgentRegistry::Registry" }, "smithy.api#documentation": "

Registry Amazon Resource Name

", "smithy.api#length": { "min": 46, "max": 2048 }, "smithy.api#pattern": "^arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}$" } }, "com.amazonaws.agentregistrycontrol#RegistryAuthorizerType": { "type": "enum", "members": { "CUSTOM_JWT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CUSTOM_JWT" } }, "AWS_IAM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AWS_IAM" } } } }, "com.amazonaws.agentregistrycontrol#RegistryFilter": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryFilterName", "traits": { "smithy.api#documentation": "

The attribute to filter on

", "smithy.api#required": {} } }, "values": { "target": "com.amazonaws.agentregistrycontrol#FilterValues", "traits": { "smithy.api#documentation": "

The values to match for the attribute

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A single filter applied to a ListRegistries request.

" } }, "com.amazonaws.agentregistrycontrol#RegistryFilterList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RegistryFilter" }, "traits": { "smithy.api#length": { "max": 10 } } }, "com.amazonaws.agentregistrycontrol#RegistryFilterName": { "type": "enum", "members": { "STATUS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "status" } }, "DISCOVERY_CONFIGURATION_AUTHORIZER_TYPE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "discoveryConfiguration.authorizerType" } } } }, "com.amazonaws.agentregistrycontrol#RegistryId": { "type": "string", "traits": { "smithy.api#documentation": "

Registry unique identifier - 12-character alphanumeric string

", "smithy.api#length": { "min": 12, "max": 16 }, "smithy.api#pattern": "^[a-zA-Z0-9]{12,16}$" } }, "com.amazonaws.agentregistrycontrol#RegistryIdentifier": { "type": "string", "traits": { "smithy.api#documentation": "

Registry identifier that accepts either ARN or ID format

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^(arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/)?[a-zA-Z0-9]{12,16}$" } }, "com.amazonaws.agentregistrycontrol#RegistryName": { "type": "string", "traits": { "smithy.api#documentation": "

Registry name with validation pattern

", "smithy.api#length": { "min": 1, "max": 64 }, "smithy.api#pattern": "^[a-zA-Z0-9][a-zA-Z0-9_\\-\\.\\/]*$" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordArn": { "type": "string", "traits": { "smithy.api#documentation": "

Registry Record Amazon Resource Name

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^arn:aws(-[^:]+)?:agent-registry:[a-z0-9-]+:[0-9]{12}:registry/[a-zA-Z0-9]{12,16}/record/[a-zA-Z0-9]{12}$" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordArtifactDownload": { "type": "structure", "members": { "sha256": { "target": "com.amazonaws.agentregistrycontrol#Sha256Hash", "traits": { "smithy.api#documentation": "

The SHA-256 checksum of the package, as 64 lowercase hexadecimal characters. The download response carries no signature that you can check, so compare the checksum of the file that you download with this value before you use the package.

" } }, "downloadUrl": { "target": "com.amazonaws.agentregistrycontrol#PresignedDownloadUrl", "traits": { "smithy.api#documentation": "

A presigned Amazon S3 URL that downloads the package. The URL is valid for up to 5 minutes, and the response doesn't include its expiry time. To get a new URL, call the operation again. Anyone who has the URL can download the package until it expires, so don't log, store, or share it.

" } } }, "traits": { "smithy.api#documentation": "

The skill package of a registry record, as a short-lived download URL and the package's SHA-256 checksum. Responses never include the package bytes.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordArtifactUpload": { "type": "structure", "members": { "content": { "target": "com.amazonaws.agentregistrycontrol#ArtifactContent", "traits": { "smithy.api#documentation": "

The ZIP archive of the skill package, up to 5 MiB (5,242,880 bytes). In a JSON request, the content is base64-encoded. The Amazon Web Services SDKs encode it for you.

", "smithy.api#required": {} } }, "sha256": { "target": "com.amazonaws.agentregistrycontrol#Sha256Hash", "traits": { "smithy.api#documentation": "

The optional SHA-256 checksum of the ZIP archive, as 64 lowercase hexadecimal characters, computed over the archive's bytes rather than its base64 text. If it doesn't match the content, the request fails with a ValidationException.

" } } }, "traits": { "smithy.api#documentation": "

A skill package to upload with a registry record: a ZIP archive of a skill that follows the Agent Skills specification. The registry validates the package asynchronously, stores it, and sets skillMd.data from the package's SKILL.md.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderConfiguration": { "type": "structure", "members": { "credentialProviderType": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderType", "traits": { "smithy.api#documentation": "

The type of credential provider.

", "smithy.api#required": {} } }, "credentialProvider": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderUnion", "traits": { "smithy.api#documentation": "

The credential provider details corresponding to the specified credential provider type.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A credential provider configuration that specifies how to authenticate when fetching descriptor content from a registry record's source URL.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderConfigurationList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderConfiguration" }, "traits": { "smithy.api#length": { "max": 1 } } }, "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderType": { "type": "enum", "members": { "OAUTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "OAUTH" } }, "IAM": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IAM" } } } }, "com.amazonaws.agentregistrycontrol#RegistryRecordCredentialProviderUnion": { "type": "union", "members": { "oauthCredentialProvider": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordOAuthCredentialProvider", "traits": { "smithy.api#documentation": "

The OAuth 2.0 credential provider details.

" } }, "iamCredentialProvider": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordIamCredentialProvider", "traits": { "smithy.api#documentation": "

The IAM role credential provider details.

" } } }, "traits": { "smithy.api#documentation": "

The credential provider details for a registry record. Exactly one member is populated, matching the configured credential provider type.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName": { "type": "string", "traits": { "smithy.api#documentation": "

Display name for a registry record

", "smithy.api#length": { "min": 1, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#RegistryRecordFilter": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordFilterName", "traits": { "smithy.api#documentation": "

The attribute to filter on

", "smithy.api#required": {} } }, "values": { "target": "com.amazonaws.agentregistrycontrol#FilterValues", "traits": { "smithy.api#documentation": "

The values to match for the attribute

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

A single filter applied to a ListRegistryRecords request.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordFilterList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordFilter" }, "traits": { "smithy.api#length": { "max": 10 } } }, "com.amazonaws.agentregistrycontrol#RegistryRecordFilterName": { "type": "enum", "members": { "NAME": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "name" } }, "STATUS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "status" } }, "RECORD_TYPE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "recordType" } } } }, "com.amazonaws.agentregistrycontrol#RegistryRecordIamCredentialProvider": { "type": "structure", "members": { "roleArn": { "target": "com.amazonaws.agentregistrycontrol#IamRoleArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the IAM role to assume for request signing.

" } }, "service": { "target": "com.amazonaws.agentregistrycontrol#IamSigningServiceName", "traits": { "smithy.api#documentation": "

The service name to use for request signing, such as execute-api. For an Amazon S3 skill source, omit it or set it to s3.

" } }, "region": { "target": "com.amazonaws.agentregistrycontrol#IamSigningRegion", "traits": { "smithy.api#documentation": "

The Amazon Web Services Region to use for request signing. If not specified, the Region is derived from the source URL hostname, falling back to the Region of the registry. For an Amazon S3 skill source, omit it or set it to the Region of the registry.

" } } }, "traits": { "smithy.api#documentation": "

The configuration for an IAM role credential provider that signs requests to a registry record's source with Amazon Web Services Signature Version 4 (SigV4). For an Amazon S3 skill source (an s3:// URL), Amazon Web Services Agent Registry assumes the role to read the object. The role must be in your Amazon Web Services account.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordId": { "type": "string", "traits": { "smithy.api#documentation": "

Registry Record unique identifier - 12-character alphanumeric string

", "smithy.api#length": { "min": 12, "max": 12 }, "smithy.api#pattern": "^[a-zA-Z0-9]{12}$" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordName": { "type": "string", "traits": { "smithy.api#documentation": "

Registry Record name

", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[a-zA-Z0-9][a-zA-Z0-9_\\-\\.\\/]*$" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordOAuthCredentialProvider": { "type": "structure", "members": { "providerArn": { "target": "com.amazonaws.agentregistrycontrol#CredentialProviderArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the OAuth 2.0 credential provider resource in Amazon Bedrock AgentCore Identity.

", "smithy.api#required": {} } }, "grantType": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordOAuthGrantType", "traits": { "smithy.api#documentation": "

The OAuth 2.0 grant type used to obtain access tokens. A GitHub skill source requires AUTHORIZATION_CODE. Other sources, such as MCP server and A2A agent card sources, use CLIENT_CREDENTIALS. A GitHub source takes exactly one OAuth credential provider, in the registry's Amazon Web Services account and Region. Only an IAM role or IAM user in the account that owns the registry can set, synchronize, or reauthorize it, and the caller needs bedrock-agentcore:GetWorkloadAccessTokenForUserId and bedrock-agentcore:GetResourceOauth2Token on the registry's workload identity, registry- followed by the registry ID.

" } }, "scopes": { "target": "com.amazonaws.agentregistrycontrol#ScopeList", "traits": { "smithy.api#documentation": "

The OAuth 2.0 scopes to request when obtaining access tokens.

" } }, "customParameters": { "target": "com.amazonaws.agentregistrycontrol#CustomParameterMap", "traits": { "smithy.api#documentation": "

Additional parameters to include in the OAuth 2.0 token request.

" } }, "returnUrl": { "target": "com.amazonaws.agentregistrycontrol#OAuthReturnUrl", "traits": { "smithy.api#documentation": "

The URL that the user's browser returns to after the user approves access on GitHub, for the AUTHORIZATION_CODE grant. There, your application completes the authorization by calling the Amazon Bedrock AgentCore Identity CompleteResourceTokenAuth operation with the userId from authorizationData. If you omit it, the user returns to the Amazon Web Services Agent Registry console, which completes the authorization when the user is signed in as the IAM principal that made the request. A request that joins an authorization already in progress uses the return URL of the request that started it.

" } } }, "traits": { "smithy.api#documentation": "

The configuration for an OAuth 2.0 credential provider that authenticates requests to a registry record's source.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordOAuthGrantType": { "type": "enum", "members": { "CLIENT_CREDENTIALS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CLIENT_CREDENTIALS" } }, "AUTHORIZATION_CODE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AUTHORIZATION_CODE" } } }, "traits": { "smithy.api#documentation": "

The OAuth 2.0 grant type that a credential provider uses to obtain access tokens. CLIENT_CREDENTIALS obtains tokens for the client application itself and is the grant for sources such as MCP server and A2A agent card sources. AUTHORIZATION_CODE obtains tokens with a user's approval and is required for GitHub skill sources. A GitHub user approves access once. Later requests from the same IAM principal for the same registry, host, credential provider, scopes, and custom parameters reuse that approval.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordResource": { "type": "resource", "identifiers": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier" }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier" } }, "create": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistryRecord" }, "read": { "target": "com.amazonaws.agentregistrycontrol#GetRegistryRecord" }, "update": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecord" }, "delete": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistryRecord" }, "list": { "target": "com.amazonaws.agentregistrycontrol#ListRegistryRecords" }, "operations": [ { "target": "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApproval" }, { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatus" } ] }, "com.amazonaws.agentregistrycontrol#RegistryRecordStatus": { "type": "enum", "members": { "DRAFT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DRAFT" } }, "PENDING_APPROVAL": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "PENDING_APPROVAL" } }, "APPROVED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "APPROVED" } }, "REJECTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "REJECTED" } }, "DEPRECATED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DEPRECATED" } }, "CREATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATING" } }, "UPDATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATING" } }, "CREATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_FAILED" } }, "UPDATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_FAILED" } }, "CREATE_PENDING_AUTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_PENDING_AUTH" } }, "UPDATE_PENDING_AUTH": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_PENDING_AUTH" } } }, "traits": { "smithy.api#documentation": "

The lifecycle status of a registry record. A record is DRAFT before it is submitted, PENDING_APPROVAL while it awaits curator review, and APPROVED after it is approved and discoverable. Rejecting a newer revision keeps the last approved revision discoverable. A DEPRECATED record isn't discoverable. CREATING, UPDATING, CREATE_FAILED, and UPDATE_FAILED reflect an asynchronous change that is in progress or has failed. CREATE_PENDING_AUTH and UPDATE_PENDING_AUTH mean that the record waits for a GitHub user to authorize access before it synchronizes from its GitHub source.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordSummary": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the parent registry that owns the record.

", "smithy.api#required": {} } }, "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the registry record.

", "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordId", "traits": { "smithy.api#documentation": "

The unique identifier of the registry record.

", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordName", "traits": { "smithy.api#documentation": "

The name of the registry record. Names are unique within a registry.

", "smithy.api#required": {} } }, "displayName": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName", "traits": { "smithy.api#documentation": "

The human-readable display name of the registry record.

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

A description of the registry record.

" } }, "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The type of the registry record, such as MCP, AGENT, SKILL, or CUSTOM.

", "smithy.api#required": {} } }, "recordVersion": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordVersion", "traits": { "smithy.api#documentation": "

The version identifier of the registry record.

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The lifecycle status of the registry record.

", "smithy.api#required": {} } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was created.

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was last updated.

", "smithy.api#required": {} } }, "createdByAutoDetection": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether the registry record was created by auto-detection. true indicates the record was automatically created by the service based on the registry's auto-detection configuration; false indicates the record was created through a control-plane API call.

" } }, "createdBy": { "target": "com.amazonaws.agentregistrycontrol#CreatorAccountId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Web Services account that created the registry record.

" } }, "provenanceSummaryList": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceSummaryList", "traits": { "smithy.api#documentation": "

The condensed provenance lineage for the registry record. Each entry contains the source relation, source identifier, and source type of an auto-detection lineage entry. Populated for records created by auto-detection.

" } }, "customMetadataSchemaComplianceStatus": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaComplianceStatus", "traits": { "smithy.api#documentation": "

Indicates whether this record's custom metadata conforms to the registry's current schema.

" } } }, "traits": { "smithy.api#documentation": "

A summary of a registry record returned by list operations. Contains identifying and lifecycle fields but omits descriptor content.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordSummaryList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordSummary" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordSynchronizedSource": { "type": "union", "members": { "s3": { "target": "com.amazonaws.agentregistrycontrol#S3SynchronizedSource", "traits": { "smithy.api#documentation": "

The Amazon S3 source that the registry read.

" } }, "gitHub": { "target": "com.amazonaws.agentregistrycontrol#GitHubSynchronizedSource", "traits": { "smithy.api#documentation": "

The GitHub source that the registry read.

" } } }, "traits": { "smithy.api#documentation": "

The source that a skill record's content was last synchronized from. Exactly one member is set, for the source's provider.

" } }, "com.amazonaws.agentregistrycontrol#RegistryRecordVersion": { "type": "string", "traits": { "smithy.api#documentation": "

Version of the registry record

", "smithy.api#length": { "min": 1, "max": 255 }, "smithy.api#pattern": "^[a-zA-Z0-9.-]+$" } }, "com.amazonaws.agentregistrycontrol#RegistryResource": { "type": "resource", "identifiers": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier" } }, "create": { "target": "com.amazonaws.agentregistrycontrol#CreateRegistry" }, "read": { "target": "com.amazonaws.agentregistrycontrol#GetRegistry" }, "update": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistry" }, "delete": { "target": "com.amazonaws.agentregistrycontrol#DeleteRegistry" }, "list": { "target": "com.amazonaws.agentregistrycontrol#ListRegistries" } }, "com.amazonaws.agentregistrycontrol#RegistryStatus": { "type": "enum", "members": { "CREATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATING" } }, "READY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "READY" } }, "UPDATING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATING" } }, "CREATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CREATE_FAILED" } }, "UPDATE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UPDATE_FAILED" } }, "DELETING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETING" } }, "DELETE_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DELETE_FAILED" } } } }, "com.amazonaws.agentregistrycontrol#RegistrySummary": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryName", "traits": { "smithy.api#documentation": "

Registry name

", "smithy.api#required": {} } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

Registry description

" } }, "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryId", "traits": { "smithy.api#documentation": "

Unique registry identifier

", "smithy.api#required": {} } }, "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

Registry Amazon Resource Name

", "smithy.api#required": {} } }, "discoveryConfiguration": { "target": "com.amazonaws.agentregistrycontrol#DiscoveryConfiguration", "traits": { "smithy.api#documentation": "

Discovery configuration for the registry

" } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryStatus", "traits": { "smithy.api#documentation": "

Current status of the registry

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the current status. Typically populated when the status indicates a failure state.

" } }, "autoDetection": { "target": "com.amazonaws.agentregistrycontrol#AutoDetection", "traits": { "smithy.api#documentation": "

The registry's auto-detection properties, including the requested configuration and the current detection status. Present only when auto-detection was configured for the registry.

" } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was created

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was last updated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Registry summary for list operations

" } }, "com.amazonaws.agentregistrycontrol#RegistrySummaryList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#RegistrySummary" } }, "com.amazonaws.agentregistrycontrol#ResourceArn": { "type": "string", "traits": { "smithy.api#documentation": "ARN of a taggable Agent Registry resource.", "smithy.api#length": { "min": 1, "max": 1011 } } }, "com.amazonaws.agentregistrycontrol#ResourceConfigurationIdentifier": { "type": "string", "traits": { "smithy.api#documentation": "

The identifier of a VPC Lattice resource configuration, specified as a resource configuration ID or ARN.

", "smithy.api#length": { "min": 20, "max": 2048 }, "smithy.api#pattern": "^((rcfg-[0-9a-z]{17})|(arn:[a-z0-9\\-]+:vpc-lattice:[a-zA-Z0-9\\-]+:\\d{12}:resourceconfiguration/rcfg-[0-9a-z]{17}))$" } }, "com.amazonaws.agentregistrycontrol#ResourceNotFoundException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The requested resource was not found.

", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.agentregistrycontrol#ResourceTagsMap": { "type": "map", "key": { "target": "com.amazonaws.agentregistrycontrol#TagKey" }, "value": { "target": "com.amazonaws.agentregistrycontrol#TagValue" }, "traits": { "smithy.api#documentation": "A map of tag keys to tag values returned by read operations (may be empty).", "smithy.api#length": { "min": 0, "max": 50 } } }, "com.amazonaws.agentregistrycontrol#RoutingDomain": { "type": "string", "traits": { "smithy.api#documentation": "

The routing domain used to resolve traffic through a private endpoint.

", "smithy.api#length": { "min": 3, "max": 255 } } }, "com.amazonaws.agentregistrycontrol#S3BucketOwnerAccountId": { "type": "string", "traits": { "smithy.api#documentation": "

A 12-digit Amazon Web Services account ID.

", "smithy.api#length": { "min": 12, "max": 12 }, "smithy.api#pattern": "^[0-9]{12}$" } }, "com.amazonaws.agentregistrycontrol#S3ObjectETag": { "type": "string", "traits": { "smithy.api#documentation": "

The entity tag (ETag) of an Amazon S3 object, without quotes.

", "smithy.api#length": { "min": 1, "max": 1024 } } }, "com.amazonaws.agentregistrycontrol#S3ObjectVersionId": { "type": "string", "traits": { "smithy.api#documentation": "

The version ID of an Amazon S3 object in a versioned bucket.

", "smithy.api#length": { "min": 1, "max": 1024 } } }, "com.amazonaws.agentregistrycontrol#S3SourceConfiguration": { "type": "structure", "members": { "bucketOwnerAccountId": { "target": "com.amazonaws.agentregistrycontrol#S3BucketOwnerAccountId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Web Services account that owns the source bucket. The registry checks that the bucket belongs to this account each time it reads the source. If you omit it for a source that uses an IAM role, the registry expects the bucket to be in the role's account. If you omit it for a source that has no credential provider, which the registry reads as a public object, the request fails with a ValidationException.

" } } }, "traits": { "smithy.api#documentation": "

The settings of a source that the registry reads from Amazon S3.

" } }, "com.amazonaws.agentregistrycontrol#S3SynchronizedSource": { "type": "structure", "members": { "url": { "target": "com.amazonaws.agentregistrycontrol#SynchronizedSourceUrl", "traits": { "smithy.api#documentation": "

The source URL that the registry read.

", "smithy.api#required": {} } }, "synchronizedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry read the source.

", "smithy.api#required": {} } }, "versionId": { "target": "com.amazonaws.agentregistrycontrol#S3ObjectVersionId", "traits": { "smithy.api#documentation": "

The version ID of the object that the registry read. Absent when the bucket isn't versioned.

" } }, "eTag": { "target": "com.amazonaws.agentregistrycontrol#S3ObjectETag", "traits": { "smithy.api#documentation": "

The entity tag (ETag) of the object that the registry read, without quotes, when the object has no version ID. Not recorded for a SKILL.md source on a registry that is encrypted with a customer managed key.

" } } }, "traits": { "smithy.api#documentation": "

An Amazon S3 source that a skill record's content was synchronized from, and the object version that the registry read. At most one of versionId and eTag is set.

" } }, "com.amazonaws.agentregistrycontrol#ScopeList": { "type": "list", "member": { "target": "smithy.api#String" } }, "com.amazonaws.agentregistrycontrol#SecurityGroupIdentifier": { "type": "string", "traits": { "smithy.api#documentation": "

The identifier of a security group.

", "smithy.api#length": { "min": 10, "max": 48 }, "smithy.api#pattern": "^sg-(([0-9a-z]{8})|([0-9a-z]{17}))$" } }, "com.amazonaws.agentregistrycontrol#SecurityGroupIds": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#SecurityGroupIdentifier" }, "traits": { "smithy.api#documentation": "

The list of security group identifiers associated with a private endpoint.

", "smithy.api#length": { "min": 0, "max": 5 } } }, "com.amazonaws.agentregistrycontrol#SelfManagedLatticeResource": { "type": "union", "members": { "resourceConfigurationIdentifier": { "target": "com.amazonaws.agentregistrycontrol#ResourceConfigurationIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the VPC Lattice resource configuration, specified as a resource configuration ID or ARN.

" } } }, "traits": { "smithy.api#documentation": "

A self-managed private endpoint backed by a VPC Lattice resource configuration. Exactly one member is set.

" } }, "com.amazonaws.agentregistrycontrol#ServiceQuotaExceededException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The request would exceed a service quota.

", "smithy.api#error": "client", "smithy.api#httpError": 402 } }, "com.amazonaws.agentregistrycontrol#Sha256Hash": { "type": "string", "traits": { "smithy.api#documentation": "

A SHA-256 checksum, as 64 lowercase hexadecimal characters.

", "smithy.api#length": { "min": 64, "max": 64 }, "smithy.api#pattern": "^[0-9a-f]{64}$" } }, "com.amazonaws.agentregistrycontrol#SourceDetails": { "type": "union", "members": { "agentcoreRuntime": { "target": "com.amazonaws.agentregistrycontrol#AgentCoreRuntimeSourceDetails", "traits": { "smithy.api#documentation": "

The source details for a registry record that was auto-detected from an Amazon Bedrock AgentCore Runtime resource. Populated when the source type is AWS::BedrockAgentCore::Runtime.

" } }, "agentcoreGateway": { "target": "com.amazonaws.agentregistrycontrol#AgentCoreGatewaySourceDetails", "traits": { "smithy.api#documentation": "

The source details for a registry record that was auto-detected from an Amazon Bedrock AgentCore Gateway resource. Populated when the source type is AWS::BedrockAgentCore::Gateway.

" } } }, "traits": { "smithy.api#documentation": "

The details about the upstream source from which a registry record was detected. Exactly one member is populated, corresponding to the source type.

" } }, "com.amazonaws.agentregistrycontrol#SourceId": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#pattern": "^arn:aws(-[^:]+)?:[a-zA-Z0-9-]+:[a-z0-9-]*:[0-9]{12}:.+$" } }, "com.amazonaws.agentregistrycontrol#SourceType": { "type": "enum", "members": { "AWS_BEDROCK_AGENTCORE_RUNTIME": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AWS::BedrockAgentCore::Runtime" } }, "AWS_BEDROCK_AGENTCORE_GATEWAY": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "AWS::BedrockAgentCore::Gateway" } } } }, "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApproval": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApprovalRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApprovalResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Submits a DRAFT registry record for approval, moving it into the registry's approval workflow. Depending on the registry's approval configuration, the record is either auto-approved or set to PENDING_APPROVAL for a curator to approve or reject.

", "smithy.api#http": { "method": "POST", "uri": "/registries/{registryId}/records/{recordId}/submit-for-approval", "code": 202 } } }, "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApprovalRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry containing the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry record to submit for approval (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#SubmitRegistryRecordForApprovalResponse": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The ARN of the registry

", "smithy.api#required": {} } }, "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The ARN of the registry record

", "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordId", "traits": { "smithy.api#documentation": "

The ID of the registry record

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The resulting status of the registry record

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the record was last updated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for submitting a registry record for approval

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#SubnetId": { "type": "string", "traits": { "smithy.api#documentation": "

Subnet identifier

", "smithy.api#length": { "min": 15, "max": 24 }, "smithy.api#pattern": "^subnet-[0-9a-zA-Z]{8,17}$" } }, "com.amazonaws.agentregistrycontrol#SubnetIds": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#SubnetId" }, "traits": { "smithy.api#documentation": "

The list of subnet identifiers in which the private endpoint network interfaces are placed.

" } }, "com.amazonaws.agentregistrycontrol#SynchronizedSourceUrl": { "type": "string", "traits": { "smithy.api#documentation": "

The URL of a source that a registry record's content was synchronized from.

", "smithy.api#length": { "min": 1, "max": 2048 }, "smithy.api#sensitive": {} } }, "com.amazonaws.agentregistrycontrol#TagKey": { "type": "string", "traits": { "smithy.api#documentation": "Key of a tag.", "smithy.api#length": { "min": 1, "max": 128 }, "smithy.api#pattern": "^[a-zA-Z0-9\\s._:/=+@-]*$" } }, "com.amazonaws.agentregistrycontrol#TagKeyList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#TagKey" }, "traits": { "smithy.api#documentation": "A list of tag keys.", "smithy.api#length": { "min": 1, "max": 50 } } }, "com.amazonaws.agentregistrycontrol#TagResource": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#TagResourceRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#TagResourceResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ServiceQuotaExceededException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Adds or overwrites one or more tags for the specified Amazon Web Services Agent Registry resource. Tags are key-value pairs that you can use to categorize and manage Amazon Web Services resources. If a tag with the same key already exists on the resource, the service replaces its value with the value you specify.

", "smithy.api#http": { "code": 204, "method": "POST", "uri": "/tags/{resourceArn+}" }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#TagResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.agentregistrycontrol#ResourceArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource to tag. Supported resources include registries and registry records.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tags": { "target": "com.amazonaws.agentregistrycontrol#TagsMap", "traits": { "smithy.api#documentation": "

The tags to apply to the resource, as a map of tag keys to tag values. Tag keys must be unique within the request.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#TagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#TagValue": { "type": "string", "traits": { "smithy.api#documentation": "Value of a tag.", "smithy.api#length": { "min": 0, "max": 256 }, "smithy.api#pattern": "^[a-zA-Z0-9\\s._:/=+@-]*$" } }, "com.amazonaws.agentregistrycontrol#TagsMap": { "type": "map", "key": { "target": "com.amazonaws.agentregistrycontrol#TagKey" }, "value": { "target": "com.amazonaws.agentregistrycontrol#TagValue" }, "traits": { "smithy.api#documentation": "A map of tag keys to tag values.", "smithy.api#length": { "min": 1, "max": 50 } } }, "com.amazonaws.agentregistrycontrol#ThrottlingException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.agentregistrycontrol#NonBlankString" } }, "traits": { "smithy.api#documentation": "

The request was denied due to request throttling; the caller may retry after a delay.

", "smithy.api#error": "client", "smithy.api#httpError": 429 } }, "com.amazonaws.agentregistrycontrol#UntagResource": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#UntagResourceRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#UntagResourceResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Removes one or more tags from the specified Amazon Web Services Agent Registry resource. The operation removes only the tags whose keys you supply; other tags on the resource remain unchanged.

", "smithy.api#http": { "code": 204, "method": "DELETE", "uri": "/tags/{resourceArn+}" }, "smithy.api#idempotent": {} } }, "com.amazonaws.agentregistrycontrol#UntagResourceRequest": { "type": "structure", "members": { "resourceArn": { "target": "com.amazonaws.agentregistrycontrol#ResourceArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the resource to remove tags from. Supported resources include registries and registry records.

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "tagKeys": { "target": "com.amazonaws.agentregistrycontrol#TagKeyList", "traits": { "smithy.api#documentation": "

The keys of the tags to remove from the resource. Tags with keys not included in this list remain on the resource.

", "smithy.api#httpQuery": "tagKeys", "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#UntagResourceResponse": { "type": "structure", "members": {}, "traits": { "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#UpdateRegistry": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ServiceQuotaExceededException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Updates an existing registry. This operation uses PATCH semantics: specify only the fields you want to change, and omit the rest to leave them unchanged. Updates are applied asynchronously and the registry transitions to the UPDATING status while they are processed.

", "smithy.api#http": { "code": 202, "method": "PATCH", "uri": "/registries/{registryId}" } } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecord": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Updates a registry record. The update is asynchronous: the operation returns the record with the UPDATING status while the registry processes it. If a GitHub user must first authorize access to the record's skill source, the operation returns the record with the UPDATE_PENDING_AUTH status instead. Fields that use update wrappers follow PATCH semantics: omit the field to leave it unchanged.

", "smithy.api#http": { "method": "PATCH", "uri": "/registries/{registryId}/records/{recordId}", "code": 202 } } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry containing the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry record to update (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordName", "traits": { "smithy.api#documentation": "

The updated name of the registry record. Omit to leave the name unchanged.

" } }, "displayName": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDisplayName", "traits": { "smithy.api#documentation": "

The updated display name of the registry record. Omit to leave the display name unchanged; provide an empty wrapper to unset it.

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescription", "traits": { "smithy.api#documentation": "

The updated description of the registry record. Omit to leave the description unchanged; provide an empty wrapper to unset it.

" } }, "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The updated type of the registry record. Omit to leave the record type unchanged.

" } }, "descriptors": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptors", "traits": { "smithy.api#documentation": "

The updated typed descriptor content for the registry record. Omit to leave the descriptors unchanged.

" } }, "artifact": { "target": "com.amazonaws.agentregistrycontrol#UpdatedRegistryRecordArtifact", "traits": { "smithy.api#documentation": "

The change to the record's uploaded skill package. Omit it to keep the current package, specify an empty object to remove an uploaded package, or specify optionalValue to upload a new package. An empty object doesn't remove a package that the record synchronizes from a source. To stop that synchronization, remove skillPackage. A request that changes skillMd.data replaces the record's package with that text, even if you omit this member.

" } }, "recordVersion": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordVersion", "traits": { "smithy.api#documentation": "

The updated version of the registry record. Omit to leave the version unchanged.

" } }, "customMetadata": { "target": "com.amazonaws.agentregistrycontrol#UpdatedCustomMetadataMap", "traits": { "smithy.api#documentation": "

The updated custom metadata for the registry record. Values can be strings (maximum 128 characters) or native JSON booleans (true or false). Omit to leave the existing metadata unchanged. Supply the wrapper with a full replacement set to update, or with a null value to clear all metadata.

" } }, "triggerSynchronization": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether to synchronize the record's descriptor content from its source. For a skill record, the registry reads the stored skillMd.source or skillPackage.source again, because it doesn't watch the source for changes. For a GitHub source, the operation also returns a new authorization link when one is needed. An update that sets a different skill source starts a synchronization even if you omit this member.

" } }, "forceAuthentication": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether to ask a GitHub user to authorize access again, even when the current authorization still works, for example to use a different GitHub account. You can use it only together with triggerSynchronization, for a GitHub source whose credential provider uses the AUTHORIZATION_CODE grant. The new authorization also replaces the one that the same IAM principal's other records in the registry use for the same host, credential provider, scopes, and custom parameters.

" } }, "provenance": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceList", "traits": { "smithy.api#documentation": "

The provenance lineage re-assertion for the registry record. This field is reserved for the Amazon Web Services Agent Registry auto-detection service principal. Requests that include this field from other callers are rejected. The source identity of an existing lineage is immutable; a re-assertion may only refresh the source details.

" } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordResponse": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the parent registry that owns the record.

", "smithy.api#required": {} } }, "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the registry record.

", "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordId", "traits": { "smithy.api#documentation": "

The unique identifier of the registry record.

", "smithy.api#required": {} } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordName", "traits": { "smithy.api#documentation": "

The name of the registry record. Names are unique within a registry.

", "smithy.api#required": {} } }, "displayName": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName", "traits": { "smithy.api#documentation": "

The human-readable display name of the registry record.

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

A description of the registry record.

" } }, "recordType": { "target": "com.amazonaws.agentregistrycontrol#RecordType", "traits": { "smithy.api#documentation": "

The type of the registry record, such as MCP, AGENT, SKILL, or CUSTOM.

", "smithy.api#required": {} } }, "descriptors": { "target": "com.amazonaws.agentregistrycontrol#Descriptors", "traits": { "smithy.api#documentation": "

The typed descriptors that define the content of the registry record.

" } }, "recordVersion": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordVersion", "traits": { "smithy.api#documentation": "

The version identifier of the registry record.

" } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The lifecycle status of the registry record. UPDATE_PENDING_AUTH means that the update waits for a GitHub user to authorize access before the record synchronizes from its GitHub source. For the authorization link, see authorizationData.

", "smithy.api#required": {} } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was created.

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry record was last updated.

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the current status. Typically populated when the status indicates a failure state.

" } }, "provenance": { "target": "com.amazonaws.agentregistrycontrol#ProvenanceList", "traits": { "smithy.api#documentation": "

The provenance lineage entries for the registry record. Populated for records created by auto-detection; each entry identifies the upstream source that the record was detected from.

" } }, "createdByAutoDetection": { "target": "smithy.api#Boolean", "traits": { "smithy.api#documentation": "

Specifies whether the registry record was created by auto-detection. true indicates the record was automatically created by the service based on the registry's auto-detection configuration; false indicates the record was created through a control-plane API call.

" } }, "createdBy": { "target": "com.amazonaws.agentregistrycontrol#CreatorAccountId", "traits": { "smithy.api#documentation": "

The ID of the Amazon Web Services account that created the registry record.

" } }, "customMetadata": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataDocument", "traits": { "smithy.api#documentation": "

The custom metadata attached to this registry record. Values are strings (maximum 128 characters) or booleans.

" } }, "customMetadataSchemaComplianceStatus": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaComplianceStatus", "traits": { "smithy.api#documentation": "

Indicates whether this record's custom metadata conforms to the registry's current schema. This status is computed at read time against the latest schema.

" } }, "authorizationData": { "target": "com.amazonaws.agentregistrycontrol#AuthorizationData", "traits": { "smithy.api#documentation": "

The authorization that a GitHub user must complete before the record's synchronization starts. Present only in this response, and only while the status is UPDATE_PENDING_AUTH. If the status is UPDATE_PENDING_AUTH but this member is absent, call UpdateRegistryRecord again with triggerSynchronization to get a new authorization link.

" } } }, "traits": { "smithy.api#documentation": "

Response structure for updating a registry record

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatus": { "type": "operation", "input": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatusRequest" }, "output": { "target": "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatusResponse" }, "errors": [ { "target": "com.amazonaws.agentregistrycontrol#AccessDeniedException" }, { "target": "com.amazonaws.agentregistrycontrol#ConflictException" }, { "target": "com.amazonaws.agentregistrycontrol#InternalServerException" }, { "target": "com.amazonaws.agentregistrycontrol#ResourceNotFoundException" }, { "target": "com.amazonaws.agentregistrycontrol#ThrottlingException" }, { "target": "com.amazonaws.agentregistrycontrol#ValidationException" } ], "traits": { "smithy.api#documentation": "

Updates the status of a registry record as part of the registry's curation workflow, for example to approve or reject a record that is pending approval, or to deprecate an approved record so that it is no longer discoverable

", "smithy.api#http": { "method": "PATCH", "uri": "/registries/{registryId}/records/{recordId}/status", "code": 202 } } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatusRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry containing the record (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RecordIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry record to update the status of (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The target status for the registry record

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the status change, for example why the record was approved, rejected, or deprecated

", "smithy.api#length": { "min": 0, "max": 255 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#input": {}, "smithy.api#references": [ { "resource": "com.amazonaws.agentregistrycontrol#RegistryResource" } ] } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRecordStatusResponse": { "type": "structure", "members": { "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The ARN of the registry

", "smithy.api#required": {} } }, "recordArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArn", "traits": { "smithy.api#documentation": "

The ARN of the registry record

", "smithy.api#required": {} } }, "recordId": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordId", "traits": { "smithy.api#documentation": "

The ID of the registry record

", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordStatus", "traits": { "smithy.api#documentation": "

The resulting status of the registry record

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the status change

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the record was last updated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for updating a registry record status

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryRequest": { "type": "structure", "members": { "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryIdentifier", "traits": { "smithy.api#documentation": "

The identifier of the registry to update (ARN or ID)

", "smithy.api#httpLabel": {}, "smithy.api#required": {}, "smithy.api#suppress": [ "MemberShouldReferenceResource" ] } }, "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryName", "traits": { "smithy.api#documentation": "

The updated name of the registry

" } }, "description": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescription", "traits": { "smithy.api#documentation": "

The updated description of the registry

" } }, "discoveryConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDiscoveryConfiguration", "traits": { "smithy.api#documentation": "

The updated discovery configuration. Changing the discovery authorization can break existing consumers that rely on the previous authorization type.

" } }, "approvalConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedApprovalConfiguration", "traits": { "smithy.api#documentation": "

The updated approval configuration. The change applies only to records that move to PENDING_APPROVAL after the update; records already in PENDING_APPROVAL are unaffected.

" } }, "customMetadataSchemaConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedCustomMetadataSchemaConfiguration", "traits": { "smithy.api#documentation": "

The new custom metadata schema configuration, which replaces the current one. You can add fields and allowed values, but you can't remove a field or an allowed value, or change a field's type.

" } }, "autoDetectionConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAutoDetectionConfiguration", "traits": { "smithy.api#documentation": "

The updated auto-detection configuration for the registry, with PATCH semantics. Omit this field to leave the current configuration unchanged. Supply an empty wrapper to unset it. Supply optionalValue to replace it.

" } } }, "traits": { "smithy.api#documentation": "

Request structure for updating a registry

", "smithy.api#input": {} } }, "com.amazonaws.agentregistrycontrol#UpdateRegistryResponse": { "type": "structure", "members": { "name": { "target": "com.amazonaws.agentregistrycontrol#RegistryName", "traits": { "smithy.api#documentation": "

The name of the registry

", "smithy.api#required": {} } }, "description": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

The description of the registry

" } }, "registryId": { "target": "com.amazonaws.agentregistrycontrol#RegistryId", "traits": { "smithy.api#documentation": "

The unique identifier of the registry

", "smithy.api#required": {} } }, "registryArn": { "target": "com.amazonaws.agentregistrycontrol#RegistryArn", "traits": { "smithy.api#documentation": "

The ARN of the registry

", "smithy.api#required": {} } }, "discoveryConfiguration": { "target": "com.amazonaws.agentregistrycontrol#DiscoveryConfiguration", "traits": { "smithy.api#documentation": "

Discovery configuration for the registry

" } }, "encryptionConfiguration": { "target": "com.amazonaws.agentregistrycontrol#EncryptionConfiguration", "traits": { "smithy.api#documentation": "

The server-side encryption configuration for the registry. Appears only when a customer-managed Amazon Web Services KMS key encrypts the registry.

" } }, "approvalConfiguration": { "target": "com.amazonaws.agentregistrycontrol#ApprovalConfiguration", "traits": { "smithy.api#documentation": "

Approval configuration for registry records

" } }, "customMetadataSchemaConfiguration": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaConfiguration", "traits": { "smithy.api#documentation": "

The custom metadata schema configuration for this registry, if one has been defined.

" } }, "status": { "target": "com.amazonaws.agentregistrycontrol#RegistryStatus", "traits": { "smithy.api#documentation": "

Current status of the registry

", "smithy.api#required": {} } }, "statusReason": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The reason for the current status. Typically populated when the status indicates a failure state.

" } }, "autoDetection": { "target": "com.amazonaws.agentregistrycontrol#AutoDetection", "traits": { "smithy.api#documentation": "

The registry's auto-detection properties, including the requested configuration and the current detection status. Present only when auto-detection was configured for the registry.

" } }, "createdAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was created

", "smithy.api#required": {} } }, "updatedAt": { "target": "com.amazonaws.agentregistrycontrol#DateTimestamp", "traits": { "smithy.api#documentation": "

The timestamp when the registry was last updated

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Response structure for updating a registry

", "smithy.api#output": {} } }, "com.amazonaws.agentregistrycontrol#UpdatedA2aAgentCardDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedA2aAgentCardDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The A2A agent card descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedA2aAgentCardDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data schema version field.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource", "traits": { "smithy.api#documentation": "

The patch for the descriptor's source field.

" } } }, "traits": { "smithy.api#documentation": "

The set of A2A agent card descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgUiDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgUiDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The AG-UI descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgUiDescriptorFields": { "type": "structure", "members": { "source": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource", "traits": { "smithy.api#documentation": "

The patch for the descriptor's source field.

" } } }, "traits": { "smithy.api#documentation": "

The set of AG-UI descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsAdditionalData": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsAdditionalDataFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The agent skills additional-data patch wrapper. Omit to leave the additional data unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsAdditionalDataFields": { "type": "structure", "members": { "skillMd": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsMdDescriptor", "traits": { "smithy.api#documentation": "

The patch for the agent skills markdown descriptor field.

" } }, "skillPackage": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsPackageDescriptor", "traits": { "smithy.api#documentation": "

The patch for the skill package source field.

" } }, "repositoryProvider": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsRepositoryProvider", "traits": { "smithy.api#documentation": "

The patch for the repository provider field.

" } }, "sourceConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsSourceConfiguration", "traits": { "smithy.api#documentation": "

The patch for the source configuration field.

" } } }, "traits": { "smithy.api#documentation": "

The set of agent skills additional-data fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsDefinitionDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsDefinitionDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The agent skills definition descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsDefinitionDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data schema version field.

" } }, "additionalData": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsAdditionalData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's additional data field.

" } } }, "traits": { "smithy.api#documentation": "

The set of agent skills definition descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsMdDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsMdDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The agent skills markdown descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsMdDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data schema version field.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource", "traits": { "smithy.api#documentation": "

The patch for the descriptor's source field.

" } } }, "traits": { "smithy.api#documentation": "

The set of agent skills markdown descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsPackageDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsPackageDescriptor", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The skill package source patch wrapper. Omit to leave the source unchanged; supply an empty object to remove it and stop synchronizing the package; supply optionalValue to replace it.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsRepositoryProvider": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsRepositoryProvider", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The repository provider patch wrapper. Omit to leave the repository provider unchanged; supply an empty object to remove it; supply optionalValue to set it. When you remove it, also remove or replace the GitHub source in the same request.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsSourceConfiguration": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#AgentSkillsSourceConfiguration", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The source configuration patch wrapper. Omit to leave the configuration unchanged; supply an empty object to remove it; supply optionalValue to replace it. When you move an Amazon S3 source to another bucket, the record keeps its configuration. In the same request, specify the new bucket's owner, or specify an empty object so that the registry expects the bucket in the role's account.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedApprovalConfiguration": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#ApprovalConfiguration", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

A wrapper for updating the approval configuration of a registry. Include this wrapper to replace the approval configuration with the specified value; omit it to leave the approval configuration unchanged.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAuthorizerConfiguration": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#AuthorizerConfiguration", "traits": { "smithy.api#documentation": "

The new authorizer configuration to set. Omit to leave the existing configuration unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Wrapper for updating an optional authorizer configuration with PATCH semantics.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedAutoDetectionConfiguration": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#AutoDetectionConfiguration", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

A wrapper for updating the auto-detection configuration of a registry with PATCH semantics. Include this wrapper to replace the auto-detection configuration with the specified value. Omit it to leave the auto-detection configuration unchanged. To clear the configuration, include the wrapper with a null optionalValue.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedCustomDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedCustomDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The custom descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedCustomDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } } }, "traits": { "smithy.api#documentation": "

The set of custom descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedCustomMetadataMap": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataDocument", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The custom metadata patch wrapper. Omit to leave the existing metadata unchanged; supply with a null value to clear all metadata; supply with key-value pairs to replace the existing metadata.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedCustomMetadataSchemaConfiguration": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#CustomMetadataSchemaConfiguration", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The custom metadata schema configuration patch wrapper. Omit to leave the existing schema unchanged.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#DataSchemaVersion", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Leaf patch wrapper for a descriptor's data schema version. Omit to leave unchanged; supply an empty object to unset; supply optionalValue to set.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDescription": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#Description", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Wrapper for updating an optional Description field with PATCH semantics

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#DescriptorData", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Leaf patch wrapper for descriptor data. Omit to leave unchanged; supply an empty object to unset; supply optionalValue to set.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#DescriptorSource", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Leaf patch wrapper for a descriptor's source configuration. Omit to leave unchanged; supply an empty object to unset; supply optionalValue to set.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDescriptors": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorsFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The top-level descriptors patch wrapper used in UpdateRegistryRecord. Omit to leave the current descriptors unchanged; supply an empty object to clear them; supply optionalValue to apply a per-field patch.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDescriptorsFields": { "type": "structure", "members": { "mcpServer": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpServerDescriptor", "traits": { "smithy.api#documentation": "

The patch for the MCP server descriptor.

" } }, "a2aAgentCard": { "target": "com.amazonaws.agentregistrycontrol#UpdatedA2aAgentCardDescriptor", "traits": { "smithy.api#documentation": "

The patch for the A2A agent card descriptor.

" } }, "agentSkillsDefinition": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgentSkillsDefinitionDescriptor", "traits": { "smithy.api#documentation": "

The patch for the agent skills definition descriptor.

" } }, "custom": { "target": "com.amazonaws.agentregistrycontrol#UpdatedCustomDescriptor", "traits": { "smithy.api#documentation": "

The patch for the custom descriptor.

" } }, "http": { "target": "com.amazonaws.agentregistrycontrol#UpdatedHttpDescriptor", "traits": { "smithy.api#documentation": "

The patch for the HTTP descriptor.

" } }, "agui": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAgUiDescriptor", "traits": { "smithy.api#documentation": "

The patch for the AG-UI descriptor.

" } } }, "traits": { "smithy.api#documentation": "

The patchable descriptor fields applied during an UpdateRegistryRecord call. Each field is independently patchable.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDiscoveryConfiguration": { "type": "structure", "members": { "authorizerConfiguration": { "target": "com.amazonaws.agentregistrycontrol#UpdatedAuthorizerConfiguration", "traits": { "smithy.api#documentation": "

Authorization configuration for the registry, with PATCH semantics

" } } }, "traits": { "smithy.api#documentation": "

The discovery configuration fields to update on a registry. Omit this structure to leave the discovery configuration unchanged.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedDisplayName": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordDisplayName", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

Leaf patch wrapper for a registry record's display name. Omit to leave unchanged; supply an empty object to unset; supply optionalValue to set.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedHttpDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedHttpDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The HTTP descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedHttpDescriptorFields": { "type": "structure", "members": { "source": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource", "traits": { "smithy.api#documentation": "

The patch for the descriptor's source field.

" } } }, "traits": { "smithy.api#documentation": "

The set of HTTP descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpServerAdditionalData": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpServerAdditionalDataFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The MCP server additional-data patch wrapper. Omit to leave the additional data unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpServerAdditionalDataFields": { "type": "structure", "members": { "tools": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpToolsDescriptor", "traits": { "smithy.api#documentation": "

The patch for the MCP tools descriptor field.

" } } }, "traits": { "smithy.api#documentation": "

The set of MCP server additional-data fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpServerDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpServerDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The MCP server descriptor patch wrapper. Omit to leave the descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpServerDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data schema version field.

" } }, "source": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorSource", "traits": { "smithy.api#documentation": "

The patch for the descriptor's source field.

" } }, "additionalData": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpServerAdditionalData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's additional data field.

" } } }, "traits": { "smithy.api#documentation": "

The set of MCP server descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpToolsDescriptor": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#UpdatedMcpToolsDescriptorFields", "traits": { "smithy.api#documentation": "

The value to set for this field. Omit the wrapper to leave the field unchanged.

" } } }, "traits": { "smithy.api#documentation": "

The MCP tools descriptor patch wrapper. Omit to leave the tools descriptor unchanged; supply an empty object to remove it; supply optionalValue to patch its fields.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedMcpToolsDescriptorFields": { "type": "structure", "members": { "data": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDescriptorData", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data field.

" } }, "dataSchemaVersion": { "target": "com.amazonaws.agentregistrycontrol#UpdatedDataSchemaVersion", "traits": { "smithy.api#documentation": "

The patch for the descriptor's data schema version field.

" } } }, "traits": { "smithy.api#documentation": "

The set of MCP tools descriptor fields that can be individually updated.

" } }, "com.amazonaws.agentregistrycontrol#UpdatedRegistryRecordArtifact": { "type": "structure", "members": { "optionalValue": { "target": "com.amazonaws.agentregistrycontrol#RegistryRecordArtifactUpload", "traits": { "smithy.api#documentation": "

The skill package to upload. It replaces the record's current package or its synchronized content.

" } } }, "traits": { "smithy.api#documentation": "

The skill package patch wrapper. Omit to leave the package unchanged; supply an empty object to remove an uploaded package; supply optionalValue to upload a new package.

" } }, "com.amazonaws.agentregistrycontrol#ValidationException": { "type": "structure", "members": { "message": { "target": "smithy.api#String", "traits": { "smithy.api#required": {} } }, "reason": { "target": "com.amazonaws.agentregistrycontrol#ValidationExceptionReason", "traits": { "smithy.api#addedDefault": {}, "smithy.api#default": "FieldValidationFailed", "smithy.api#documentation": "

The reason the request failed validation.

", "smithy.api#required": {} } }, "fieldList": { "target": "com.amazonaws.agentregistrycontrol#ValidationExceptionFieldList", "traits": { "smithy.api#documentation": "

The list of input fields that failed validation.

" } } }, "traits": { "smithy.api#documentation": "

The request failed validation of one or more input fields.

", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.agentregistrycontrol#ValidationExceptionField": { "type": "structure", "members": { "name": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The name of the field that failed validation.

", "smithy.api#required": {} } }, "message": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

A description of why the field failed validation.

", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

Describes a single input field that failed validation.

" } }, "com.amazonaws.agentregistrycontrol#ValidationExceptionFieldList": { "type": "list", "member": { "target": "com.amazonaws.agentregistrycontrol#ValidationExceptionField" } }, "com.amazonaws.agentregistrycontrol#ValidationExceptionReason": { "type": "enum", "members": { "CANNOT_PARSE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "CannotParse" } }, "FIELD_VALIDATION_FAILED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "FieldValidationFailed" } }, "IDEMPOTENT_PARAMETER_MISMATCH_EXCEPTION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IdempotentParameterMismatchException" } }, "ROOT_EVENT_IN_OTHER_SESSION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EventInOtherSession" } }, "RESOURCE_CONFLICT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ResourceConflict" } }, "UNSUPPORTED_IN_REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "UnsupportedInRegion" } } } }, "com.amazonaws.agentregistrycontrol#VpcIdentifier": { "type": "string", "traits": { "smithy.api#documentation": "

The identifier of a VPC.

", "smithy.api#length": { "min": 10, "max": 48 }, "smithy.api#pattern": "^vpc-(([0-9a-z]{8})|([0-9a-z]{17}))$" } }, "com.amazonaws.agentregistrycontrol#WorkloadIdentityDetails": { "type": "structure", "members": { "workloadIdentityArn": { "target": "smithy.api#String", "traits": { "smithy.api#documentation": "

The Amazon Resource Name (ARN) of the workload identity associated with the source resource.

", "smithy.api#length": { "min": 1, "max": 1024 }, "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "

The workload identity details associated with a source resource. Present on the source details of a provenance entry when the upstream resource has a workload identity configured.

" } } } }