Sign in

v1

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

Updates an existing registry record. This operation uses PATCH semantics, so you only need to specify the fields you want to change. The update is processed asynchronously and returns HTTP 202 Accepted.

patch/registries/{registryId}/records/{recordId}

Path parameters

registryIdstring required

The identifier of the registry containing the record. You can specify either the Amazon Resource Name (ARN) or the ID of the registry.

recordIdstring required

The identifier of the registry record to update. You can specify either the Amazon Resource Name (ARN) or the ID of the record.

Request body

namestring

The updated name for the registry record.

descriptorType'MCP' | 'A2A' | 'CUSTOM' | 'AGENT_SKILLS'

The updated descriptor type for the registry record. Changing the descriptor type may require updating the <code>descriptors</code> field to match the new type's schema requirements.

recordVersionstring

The version of the registry record for optimistic locking. If provided, it must match the current version of the record. The service automatically increments the version after a successful update.

triggerSynchronizationboolean

Whether to trigger synchronization using the stored or provided configuration. When set to <code>true</code>, the service will synchronize the record metadata from the configured external source.

Response

Success

registryArnstring required

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

recordArnstring required

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

recordIdstring required

The unique identifier of the updated registry record.

namestring required

The name of the updated registry record.

descriptionstring password

The description of the updated registry record.

descriptorType'MCP' | 'A2A' | 'CUSTOM' | 'AGENT_SKILLS' required

The descriptor type of the updated registry record. Possible values are <code>MCP</code>, <code>A2A</code>, <code>CUSTOM</code>, and <code>AGENT_SKILLS</code>.

recordVersionstring

The version of the updated registry record.

status'DRAFT' | 'PENDING_APPROVAL' | 'APPROVED' | 'REJECTED' | 'DEPRECATED' | 'CREATING' | 'UPDATING' | 'CREATE_FAILED' | 'UPDATE_FAILED' required

The current status of the updated registry record. Possible values include <code>CREATING</code>, <code>DRAFT</code>, <code>APPROVED</code>, <code>PENDING_APPROVAL</code>, <code>REJECTED</code>, <code>DEPRECATED</code>, <code>UPDATING</code>, <code>CREATE_FAILED</code>, and <code>UPDATE_FAILED</code>.

createdAtstring date-time required

The timestamp when the registry record was created.

updatedAtstring date-time required

The timestamp when the registry record was last updated.

statusReasonstring

The reason for the current status of the updated registry record.

synchronizationType'URL'

The synchronization type of the updated registry record.