{ "version":"2.0", "metadata":{ "apiVersion":"2026-01-01", "auth":["aws.auth#sigv4"], "endpointPrefix":"aidevops", "protocol":"rest-json", "protocols":["rest-json"], "serviceFullName":"AWS DevOps Agent Service", "serviceId":"DevOps Agent", "signatureVersion":"v4", "signingName":"aidevops", "uid":"devops-agent-2026-01-01" }, "operations":{ "AllowVendedLogDeliveryForResource":{ "name":"AllowVendedLogDeliveryForResource", "http":{ "method":"POST", "requestUri":"/allow-vended-log-delivery-for-resource", "responseCode":200 }, "input":{"shape":"AllowVendedLogDeliveryForResourceInput"}, "output":{"shape":"AllowVendedLogDeliveryForResourceOutput"}, "errors":[ {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Authorize Ingestion Hub subscription operation.

", "endpoint":{"hostPrefix":"cp."} }, "AssociateService":{ "name":"AssociateService", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations", "responseCode":201 }, "input":{"shape":"AssociateServiceInput"}, "output":{"shape":"AssociateServiceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Adds a specific service association to an AgentSpace. It overwrites the existing association of the same service. Returns 201 Created on success.

", "endpoint":{"hostPrefix":"cp."} }, "CreateAgentSpace":{ "name":"CreateAgentSpace", "http":{ "method":"POST", "requestUri":"/v1/agentspaces", "responseCode":201 }, "input":{"shape":"CreateAgentSpaceInput"}, "output":{"shape":"CreateAgentSpaceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"}, {"shape":"ResourceNotFoundException"} ], "documentation":"

Creates a new AgentSpace with the specified name and description. Duplicate space names are allowed.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "CreateBacklogTask":{ "name":"CreateBacklogTask", "http":{ "method":"POST", "requestUri":"/backlog/agent-space/{agentSpaceId}/tasks", "responseCode":201 }, "input":{"shape":"CreateBacklogTaskRequest"}, "output":{"shape":"CreateBacklogTaskResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Creates a new backlog task in the specified agent space

", "endpoint":{"hostPrefix":"dp."}, "idempotent":true }, "CreateChat":{ "name":"CreateChat", "http":{ "method":"POST", "requestUri":"/agents/agent-space/{agentSpaceId}/chat/create", "responseCode":200 }, "input":{"shape":"CreateChatRequest"}, "output":{"shape":"CreateChatResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Creates a new chat execution in the specified agent space

", "endpoint":{"hostPrefix":"dp."} }, "CreatePrivateConnection":{ "name":"CreatePrivateConnection", "http":{ "method":"POST", "requestUri":"/v1/private-connections", "responseCode":200 }, "input":{"shape":"CreatePrivateConnectionInput"}, "output":{"shape":"CreatePrivateConnectionOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Creates a Private Connection to a target resource.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "DeleteAgentSpace":{ "name":"DeleteAgentSpace", "http":{ "method":"DELETE", "requestUri":"/v1/agentspaces/{agentSpaceId}", "responseCode":204 }, "input":{"shape":"DeleteAgentSpaceInput"}, "output":{"shape":"DeleteAgentSpaceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Deletes an AgentSpace. This operation is idempotent and returns a 204 No Content response on success.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "DeletePrivateConnection":{ "name":"DeletePrivateConnection", "http":{ "method":"DELETE", "requestUri":"/v1/private-connections/{name}", "responseCode":200 }, "input":{"shape":"DeletePrivateConnectionInput"}, "output":{"shape":"DeletePrivateConnectionOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Deletes a Private Connection. The deletion is asynchronous and returns DELETE_IN_PROGRESS status.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "DeregisterService":{ "name":"DeregisterService", "http":{ "method":"DELETE", "requestUri":"/v1/services/{serviceId}", "responseCode":200 }, "input":{"shape":"DeregisterServiceInput"}, "output":{"shape":"DeregisterServiceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Deregister a service

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "DescribePrivateConnection":{ "name":"DescribePrivateConnection", "http":{ "method":"GET", "requestUri":"/v1/private-connections/{name}", "responseCode":200 }, "input":{"shape":"DescribePrivateConnectionInput"}, "output":{"shape":"DescribePrivateConnectionOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves details of an existing Private Connection.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "DisableOperatorApp":{ "name":"DisableOperatorApp", "http":{ "method":"DELETE", "requestUri":"/v1/agentspaces/{agentSpaceId}/operator", "responseCode":200 }, "input":{"shape":"DisableOperatorAppInput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"IdentityCenterServiceException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Disable the Operator App for the specified AgentSpace

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "DisassociateService":{ "name":"DisassociateService", "http":{ "method":"DELETE", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/{associationId}", "responseCode":204 }, "input":{"shape":"DisassociateServiceInput"}, "output":{"shape":"DisassociateServiceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Deletes a specific service association from an AgentSpace. This operation is idempotent and returns a 204 No Content response on success.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "EnableOperatorApp":{ "name":"EnableOperatorApp", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/{agentSpaceId}/operator", "responseCode":200 }, "input":{"shape":"EnableOperatorAppInput"}, "output":{"shape":"EnableOperatorAppOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"IdentityCenterServiceException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Enable the Operator App to access the given AgentSpace

", "endpoint":{"hostPrefix":"cp."} }, "GetAccountUsage":{ "name":"GetAccountUsage", "http":{ "method":"GET", "requestUri":"/usage/account", "responseCode":200 }, "input":{"shape":"GetAccountUsageInput"}, "output":{"shape":"GetAccountUsageOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves monthly account usage metrics and limits for the AWS account.

", "endpoint":{"hostPrefix":"dp."}, "readonly":true }, "GetAgentSpace":{ "name":"GetAgentSpace", "http":{ "method":"GET", "requestUri":"/v1/agentspaces/{agentSpaceId}", "responseCode":200 }, "input":{"shape":"GetAgentSpaceInput"}, "output":{"shape":"GetAgentSpaceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves detailed information about a specific AgentSpace.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "GetAssociation":{ "name":"GetAssociation", "http":{ "method":"GET", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/{associationId}", "responseCode":200 }, "input":{"shape":"GetAssociationInput"}, "output":{"shape":"GetAssociationOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves given associations configured for a specific AgentSpace.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "GetBacklogTask":{ "name":"GetBacklogTask", "http":{ "method":"GET", "requestUri":"/backlog/agent-space/{agentSpaceId}/tasks/{taskId}", "responseCode":200 }, "input":{"shape":"GetBacklogTaskRequest"}, "output":{"shape":"GetBacklogTaskResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Gets a backlog task for the specified agent space and task id

", "endpoint":{"hostPrefix":"dp."}, "readonly":true }, "GetOperatorApp":{ "name":"GetOperatorApp", "http":{ "method":"GET", "requestUri":"/v2/agentspaces/{agentSpaceId}/operator", "responseCode":200 }, "input":{"shape":"GetOperatorAppInput"}, "output":{"shape":"GetOperatorAppOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Get the full auth configuration of operator including any enabled auth flow

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "GetRecommendation":{ "name":"GetRecommendation", "http":{ "method":"GET", "requestUri":"/backlog/agent-space/{agentSpaceId}/recommendations/{recommendationId}", "responseCode":200 }, "input":{"shape":"GetRecommendationRequest"}, "output":{"shape":"GetRecommendationResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves a specific recommendation by its ID

", "endpoint":{"hostPrefix":"dp."}, "readonly":true }, "GetService":{ "name":"GetService", "http":{ "method":"GET", "requestUri":"/v1/services/{serviceId}", "responseCode":200 }, "input":{"shape":"GetServiceInput"}, "output":{"shape":"GetServiceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves given service by it's unique identifier

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListAgentSpaces":{ "name":"ListAgentSpaces", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/list", "responseCode":200 }, "input":{"shape":"ListAgentSpacesInput"}, "output":{"shape":"ListAgentSpacesOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists all AgentSpaces with optional pagination.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListAssociations":{ "name":"ListAssociations", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/list", "responseCode":200 }, "input":{"shape":"ListAssociationsInput"}, "output":{"shape":"ListAssociationsOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List all associations for given AgentSpace

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListBacklogTasks":{ "name":"ListBacklogTasks", "http":{ "method":"POST", "requestUri":"/backlog/agent-space/{agentSpaceId}/tasks/list", "responseCode":200 }, "input":{"shape":"ListBacklogTasksRequest"}, "output":{"shape":"ListBacklogTasksResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists backlog tasks in the specified agent space with optional filtering and sorting

", "endpoint":{"hostPrefix":"dp."} }, "ListChats":{ "name":"ListChats", "http":{ "method":"GET", "requestUri":"/agents/agent-space/{agentSpaceId}/chat/list", "responseCode":200 }, "input":{"shape":"ListChatsRequest"}, "output":{"shape":"ListChatsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Retrieves a paginated list of the user's recent chat executions

", "endpoint":{"hostPrefix":"dp."} }, "ListExecutions":{ "name":"ListExecutions", "http":{ "method":"POST", "requestUri":"/journal/agent-space/{agentSpaceId}/executions", "responseCode":200 }, "input":{"shape":"ListExecutionsRequest"}, "output":{"shape":"ListExecutionsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List executions

", "endpoint":{"hostPrefix":"dp."} }, "ListGoals":{ "name":"ListGoals", "http":{ "method":"POST", "requestUri":"/backlog/agent-space/{agentSpaceId}/goals/list", "responseCode":200 }, "input":{"shape":"ListGoalsRequest"}, "output":{"shape":"ListGoalsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists goals in the specified agent space with optional filtering

", "endpoint":{"hostPrefix":"dp."} }, "ListJournalRecords":{ "name":"ListJournalRecords", "http":{ "method":"POST", "requestUri":"/journal/agent-space/{agentSpaceId}/journalRecords", "responseCode":200 }, "input":{"shape":"ListJournalRecordsRequest"}, "output":{"shape":"ListJournalRecordsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List journal records for a specific execution

", "endpoint":{"hostPrefix":"dp."} }, "ListPendingMessages":{ "name":"ListPendingMessages", "http":{ "method":"POST", "requestUri":"/agents/agent-space/{agentSpaceId}/pendingMessages", "responseCode":200 }, "input":{"shape":"ListPendingMessagesRequest"}, "output":{"shape":"ListPendingMessagesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List pending messages for a specific execution.

", "endpoint":{"hostPrefix":"dp."} }, "ListPrivateConnections":{ "name":"ListPrivateConnections", "http":{ "method":"GET", "requestUri":"/v1/private-connections", "responseCode":200 }, "input":{"shape":"ListPrivateConnectionsInput"}, "output":{"shape":"ListPrivateConnectionsOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists all Private Connections in the caller's account.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListRecommendations":{ "name":"ListRecommendations", "http":{ "method":"POST", "requestUri":"/backlog/agent-space/{agentSpaceId}/recommendations/list", "responseCode":200 }, "input":{"shape":"ListRecommendationsRequest"}, "output":{"shape":"ListRecommendationsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists recommendations for the specified agent space

", "endpoint":{"hostPrefix":"dp."} }, "ListServices":{ "name":"ListServices", "http":{ "method":"POST", "requestUri":"/v1/services/list", "responseCode":200 }, "input":{"shape":"ListServicesInput"}, "output":{"shape":"ListServicesOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List a list of registered service on the account level.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Lists tags for the specified AWS DevOps Agent resource.

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "ListWebhooks":{ "name":"ListWebhooks", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/{associationId}/webhooks/list", "responseCode":200 }, "input":{"shape":"ListWebhooksInput"}, "output":{"shape":"ListWebhooksOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

List all webhooks for given Association

", "endpoint":{"hostPrefix":"cp."}, "readonly":true }, "RegisterService":{ "name":"RegisterService", "http":{ "method":"POST", "requestUri":"/v1/register/{service}", "responseCode":201 }, "input":{"shape":"RegisterServiceInput"}, "output":{"shape":"RegisterServiceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"InvalidParameterException"}, {"shape":"ThrottlingException"} ], "documentation":"

This operation registers the specified service

", "endpoint":{"hostPrefix":"cp."} }, "SendMessage":{ "name":"SendMessage", "http":{ "method":"POST", "requestUri":"/agents/agent-space/{agentSpaceId}/chat/sendMessage", "responseCode":200 }, "input":{"shape":"SendMessageRequest"}, "output":{"shape":"SendMessageResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Sends a chat message and streams the response for the specified agent space execution

", "endpoint":{"hostPrefix":"dp."} }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"TagResourceRequest"}, "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Adds or overwrites tags for the specified AWS DevOps Agent resource.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{resourceArn}", "responseCode":204 }, "input":{"shape":"UntagResourceRequest"}, "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Removes tags from the specified AWS DevOps Agent resource.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true }, "UpdateAgentSpace":{ "name":"UpdateAgentSpace", "http":{ "method":"PATCH", "requestUri":"/v1/agentspaces/{agentSpaceId}", "responseCode":200 }, "input":{"shape":"UpdateAgentSpaceInput"}, "output":{"shape":"UpdateAgentSpaceOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Updates the information of an existing AgentSpace.

", "endpoint":{"hostPrefix":"cp."} }, "UpdateAssociation":{ "name":"UpdateAssociation", "http":{ "method":"PATCH", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/{associationId}", "responseCode":200 }, "input":{"shape":"UpdateAssociationInput"}, "output":{"shape":"UpdateAssociationOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Partially updates the configuration of an existing service association for an AgentSpace. Present fields are fully replaced; absent fields are left unchanged. Returns 200 OK on success.

", "endpoint":{"hostPrefix":"cp."} }, "UpdateBacklogTask":{ "name":"UpdateBacklogTask", "http":{ "method":"PATCH", "requestUri":"/backlog/agent-space/{agentSpaceId}/tasks/{taskId}", "responseCode":200 }, "input":{"shape":"UpdateBacklogTaskRequest"}, "output":{"shape":"UpdateBacklogTaskResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Update an existing backlog task.

", "endpoint":{"hostPrefix":"dp."} }, "UpdateGoal":{ "name":"UpdateGoal", "http":{ "method":"PATCH", "requestUri":"/backlog/agent-space/{agentSpaceId}/goals/{goalId}", "responseCode":200 }, "input":{"shape":"UpdateGoalRequest"}, "output":{"shape":"UpdateGoalResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Update an existing goal

", "endpoint":{"hostPrefix":"dp."} }, "UpdateOperatorAppIdpConfig":{ "name":"UpdateOperatorAppIdpConfig", "http":{ "method":"PATCH", "requestUri":"/v1/agentspaces/{agentSpaceId}/operator/idp", "responseCode":200 }, "input":{"shape":"UpdateOperatorAppIdpConfigInput"}, "output":{"shape":"UpdateOperatorAppIdpConfigOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Update the external Identity Provider configuration for the Operator App

" }, "UpdatePrivateConnectionCertificate":{ "name":"UpdatePrivateConnectionCertificate", "http":{ "method":"POST", "requestUri":"/v1/private-connections/{name}/certificate", "responseCode":200 }, "input":{"shape":"UpdatePrivateConnectionCertificateInput"}, "output":{"shape":"UpdatePrivateConnectionCertificateOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Updates the certificate associated with a Private Connection.

", "endpoint":{"hostPrefix":"cp."} }, "UpdateRecommendation":{ "name":"UpdateRecommendation", "http":{ "method":"PATCH", "requestUri":"/backlog/agent-space/{agentSpaceId}/recommendations/{recommendationId}", "responseCode":200 }, "input":{"shape":"UpdateRecommendationRequest"}, "output":{"shape":"UpdateRecommendationResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Updates an existing recommendation with new content, status, or metadata

", "endpoint":{"hostPrefix":"dp."}, "idempotent":true }, "ValidateAwsAssociations":{ "name":"ValidateAwsAssociations", "http":{ "method":"POST", "requestUri":"/v1/agentspaces/{agentSpaceId}/associations/validate", "responseCode":204 }, "input":{"shape":"ValidateAwsAssociationsInput"}, "output":{"shape":"ValidateAwsAssociationsOutput"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ContentSizeExceededException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ConflictException"}, {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InvalidParameterException"} ], "documentation":"

Validates an aws association and set status and returns a 204 No Content response on success.

", "endpoint":{"hostPrefix":"cp."}, "idempotent":true } }, "shapes":{ "AWSConfiguration":{ "type":"structure", "required":[ "assumableRoleArn", "accountId", "accountType" ], "members":{ "assumableRoleArn":{ "shape":"RoleArn", "documentation":"

Role ARN to be assumed by AIDevOps to operate on behalf of customer.

" }, "accountId":{ "shape":"AWSConfigurationAccountIdString", "documentation":"

AWS Account Id corresponding to provided resources.

" }, "accountType":{ "shape":"MonitorAccountType", "documentation":"

Account Type 'monitor' for AIDevOps monitoring.

" } }, "documentation":"

Configuration for AWS monitor account integration, allowing AIDevOps to monitor AWS resources.

" }, "AWSConfigurationAccountIdString":{ "type":"string", "pattern":"\\d{12}" }, "AccessDeniedException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing why access was denied.

" } }, "documentation":"

Access to the requested resource is denied due to insufficient permissions.

", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AdditionalServiceDetails":{ "type":"structure", "members":{ "github":{ "shape":"RegisteredGithubServiceDetails", "documentation":"

GitHub-specific service details.

" }, "slack":{ "shape":"RegisteredSlackServiceDetails", "documentation":"

Slack-specific service details.

" }, "mcpserverdatadog":{ "shape":"RegisteredMCPServerDetails", "documentation":"

Datadog MCP server-specific service details.

" }, "mcpserver":{ "shape":"RegisteredMCPServerDetails", "documentation":"

MCP server-specific service details.

" }, "servicenow":{ "shape":"RegisteredServiceNowDetails", "documentation":"

ServiceNow-specific service details.

" }, "gitlab":{ "shape":"RegisteredGitLabServiceDetails", "documentation":"

GitLab-specific service details.

" }, "mcpserversplunk":{ "shape":"RegisteredMCPServerDetails", "documentation":"

Splunk MCP server-specific service details.

" }, "mcpservernewrelic":{ "shape":"RegisteredNewRelicDetails", "documentation":"

New Relic MCP server-specific service details.

" }, "azuredevops":{ "shape":"RegisteredAzureDevOpsServiceDetails", "documentation":"

Azure DevOps specific service details.

" }, "azureidentity":{ "shape":"RegisteredAzureIdentityDetails", "documentation":"

Azure identity details for services using Azure authentication.

" }, "mcpservergrafana":{ "shape":"RegisteredGrafanaServerDetails", "documentation":"

Grafana MCP server-specific service details.

" }, "pagerduty":{ "shape":"RegisteredPagerDutyDetails", "documentation":"

Pagerduty service details.

" } }, "documentation":"

Union of service-specific details for different service types.

", "union":true }, "AdditionalServiceRegistrationStep":{ "type":"structure", "members":{ "oauth":{ "shape":"OAuthAdditionalStepDetails", "documentation":"

OAuth authorization step required.

" } }, "documentation":"

Additional steps required to complete service registration.

", "union":true }, "AgentSpace":{ "type":"structure", "required":[ "name", "createdAt", "updatedAt", "agentSpaceId" ], "members":{ "name":{ "shape":"AgentSpaceName", "documentation":"

The name of the AgentSpace.

" }, "description":{ "shape":"Description", "documentation":"

The description of the AgentSpace.

" }, "locale":{ "shape":"Locale", "documentation":"

The locale for the AgentSpace, which determines the language used in agent responses.

" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the resource was created.

" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the resource was last updated.

" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

" }, "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

" } }, "documentation":"

Represents a complete AgentSpace with all its properties, timestamps, encryption settings, and unique identifier.

" }, "AgentSpaceId":{ "type":"string", "documentation":"

Unique identifier for an agent space (allows alphanumeric characters and hyphens; 1-64 characters)

", "pattern":"[a-zA-Z0-9-]{1,64}" }, "AgentSpaceList":{ "type":"list", "member":{"shape":"AgentSpace"}, "documentation":"

A list of AgentSpace resources.

" }, "AgentSpaceName":{ "type":"string", "documentation":"

Agent space name field

", "max":255, "min":1, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+" }, "AllowVendedLogDeliveryForResourceInput":{ "type":"structure", "required":[ "resourceArnBeingAuthorized", "deliverySourceArn" ], "members":{ "resourceArnBeingAuthorized":{ "shape":"String", "documentation":"

The ARN of the resource being authorized for vended log delivery.

" }, "deliverySourceArn":{ "shape":"AllowVendedLogDeliveryForResourceInputDeliverySourceArnString", "documentation":"

The ARN of the delivery source for vended log delivery.

" }, "logType":{ "shape":"String", "documentation":"

The type of log to be delivered.

" } }, "documentation":"

Input for authorizing vended log delivery for a resource.

" }, "AllowVendedLogDeliveryForResourceInputDeliverySourceArnString":{ "type":"string", "pattern":"arn:.*" }, "AllowVendedLogDeliveryForResourceOutput":{ "type":"structure", "members":{ "message":{ "shape":"String", "documentation":"

A message describing the result of the authorization operation.

" } }, "documentation":"

Output for the vended log delivery authorization operation.

" }, "ApiKeyValue":{ "type":"string", "documentation":"

API Key Value for service.

", "min":1, "sensitive":true }, "AssistantMessage":{ "type":"list", "member":{"shape":"AssistantMessageBlock"} }, "AssistantMessageBlock":{ "type":"structure", "members":{ "text":{ "shape":"String", "documentation":"

Text content from the assistant.

" }, "toolUse":{ "shape":"Document", "documentation":"

Tool use request from the assistant.

" } }, "documentation":"

A block of content in an assistant message.

", "union":true }, "AssociateServiceInput":{ "type":"structure", "required":[ "agentSpaceId", "serviceId", "configuration" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "serviceId":{ "shape":"ServiceId", "documentation":"

The unique identifier of the service.

" }, "configuration":{ "shape":"ServiceConfiguration", "documentation":"

The configuration that directs how AgentSpace interacts with the given service.

" } }, "documentation":"

Input for creating a new service association within an AgentSpace.

" }, "AssociateServiceOutput":{ "type":"structure", "required":["association"], "members":{ "association":{"shape":"Association"}, "webhook":{ "shape":"GenericWebhook", "documentation":"

Generic webhook configuration

" } }, "documentation":"

Output containing the newly created association and optional webhook configuration.

" }, "Association":{ "type":"structure", "required":[ "agentSpaceId", "createdAt", "updatedAt", "associationId", "serviceId", "configuration" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the resource was created.

" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the resource was last updated.

" }, "status":{ "shape":"ValidationStatus", "documentation":"

Validation status

" }, "associationId":{ "shape":"AssociationId", "documentation":"

The unique identifier of the given association.

" }, "serviceId":{ "shape":"ServiceId", "documentation":"

The identifier for associated service

" }, "configuration":{ "shape":"ServiceConfiguration", "documentation":"

The configuration that directs how AgentSpace interacts with the given service.

" } }, "documentation":"

Represents a service association within an AgentSpace, defining how the agent interacts with external services.

" }, "AssociationId":{ "type":"string", "documentation":"

Unique identifier for a service association within an AgentSpace

", "max":255, "min":1, "pattern":"[a-zA-Z0-9-]+" }, "AssociationsList":{ "type":"list", "member":{"shape":"Association"}, "documentation":"

A list of service associations.

" }, "AuthFlow":{ "type":"string", "documentation":"

Authentication flow type for operator app.

", "enum":[ "iam", "idc", "idp" ] }, "AzureConfiguration":{ "type":"structure", "required":["subscriptionId"], "members":{ "subscriptionId":{ "shape":"String", "documentation":"

Azure subscription ID corresponding to provided resources.

" } }, "documentation":"

Configuration for Azure subscription integration.

" }, "AzureDevOpsConfiguration":{ "type":"structure", "required":[ "organizationName", "projectId", "projectName" ], "members":{ "organizationName":{ "shape":"String", "documentation":"

Azure DevOps organization name.

" }, "projectId":{ "shape":"String", "documentation":"

Azure DevOps project ID.

" }, "projectName":{ "shape":"String", "documentation":"

Azure DevOps project name.

" } }, "documentation":"

Configuration for Azure DevOps project integration.

" }, "BackLogTimestamp":{ "type":"timestamp", "documentation":"

Timestamp format used for backlog operations

", "timestampFormat":"iso8601" }, "BacklogTaskDescription":{ "type":"string", "documentation":"

Description for a backlog task (allows printable ASCII characters, tabs, and newlines; up to 10000 characters)

", "max":10000, "min":0 }, "BacklogTaskTitle":{ "type":"string", "documentation":"

Title for a backlog task (allows printable ASCII characters, tabs, and newlines; 1-400 characters)

", "max":400, "min":1 }, "Boolean":{ "type":"boolean", "box":true }, "CertificateString":{ "type":"string", "documentation":"

String type for certificate or certificate chain.

", "max":32768, "min":1 }, "ChatExecution":{ "type":"structure", "required":[ "executionId", "createdAt" ], "members":{ "executionId":{ "shape":"ResourceId", "documentation":"

The unique identifier for the execution

" }, "createdAt":{ "shape":"Timestamp", "documentation":"

Timestamp when the chat was created

" }, "updatedAt":{ "shape":"Timestamp", "documentation":"

Timestamp when the chat was last updated

" }, "summary":{ "shape":"String", "documentation":"

Summary or title of the chat

" } }, "documentation":"

A single chat execution summary

" }, "ChatExecutionList":{ "type":"list", "member":{"shape":"ChatExecution"} }, "ClientId":{ "type":"string", "documentation":"

Client ID for service authentication.

", "max":255, "min":1, "pattern":"[a-zA-Z0-9._-]+", "sensitive":true }, "ClientSecret":{ "type":"string", "documentation":"

Client secret for service authentication.

", "max":512, "min":1, "pattern":"[\\S]+", "sensitive":true }, "ConflictException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing the conflict.

" } }, "documentation":"

The request conflicts with the current state of the resource.

", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "ContentSizeExceededException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"

This exception is thrown when the content size exceeds the allowed limit.

", "error":{ "httpStatusCode":413, "senderFault":true }, "exception":true }, "CreateAgentSpaceInput":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"AgentSpaceName", "documentation":"

The name of the AgentSpace.

" }, "description":{ "shape":"Description", "documentation":"

The description of the AgentSpace.

" }, "locale":{ "shape":"Locale", "documentation":"

The locale for the AgentSpace, which determines the language used in agent responses.

" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

" }, "clientToken":{ "shape":"CreateAgentSpaceInputClientTokenString", "documentation":"

Client-provided token to ensure request idempotency. When the same token is provided in subsequent calls, the same response is returned within a 8-hour window.

", "idempotencyToken":true }, "tags":{ "shape":"Tags", "documentation":"

Tags to add to the AgentSpace at creation time.

" } }, "documentation":"

Input for creating a new AgentSpace.

" }, "CreateAgentSpaceInputClientTokenString":{ "type":"string", "max":64, "min":0, "pattern":"[!-~]+" }, "CreateAgentSpaceOutput":{ "type":"structure", "required":["agentSpace"], "members":{ "agentSpace":{"shape":"AgentSpace"}, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the created AgentSpace.

" } }, "documentation":"

Output containing the newly created AgentSpace.

" }, "CreateBacklogTaskRequest":{ "type":"structure", "required":[ "agentSpaceId", "taskType", "title", "priority" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space where the task will be created

", "location":"uri", "locationName":"agentSpaceId" }, "reference":{ "shape":"ReferenceInput", "documentation":"

Optional reference information for the task

" }, "taskType":{ "shape":"TaskType", "documentation":"

The type of task being created

" }, "title":{ "shape":"BacklogTaskTitle", "documentation":"

The title of the backlog task

" }, "description":{ "shape":"BacklogTaskDescription", "documentation":"

Optional detailed description of the task

" }, "priority":{ "shape":"Priority", "documentation":"

The priority level of the task

" }, "clientToken":{ "shape":"String", "documentation":"

Client-provided token for idempotent operations

", "idempotencyToken":true } }, "documentation":"

Request structure for creating a new backlog task

" }, "CreateBacklogTaskResponse":{ "type":"structure", "required":["task"], "members":{ "task":{ "shape":"Task", "documentation":"

The newly created task object

" } }, "documentation":"

Response structure containing the created backlog task

" }, "CreateChatRequest":{ "type":"structure", "required":[ "agentSpaceId", "userId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "location":"uri", "locationName":"agentSpaceId" }, "userId":{ "shape":"ResourceId", "documentation":"

The user identifier for the chat

", "location":"querystring", "locationName":"userId" }, "userType":{ "shape":"UserType", "documentation":"

The authentication type of the user

", "location":"querystring", "locationName":"userType" } }, "documentation":"

Request structure for creating a new chat

" }, "CreateChatResponse":{ "type":"structure", "required":[ "executionId", "createdAt" ], "members":{ "executionId":{ "shape":"ResourceId", "documentation":"

The unique identifier for the created execution

" }, "createdAt":{ "shape":"Timestamp", "documentation":"

Timestamp when the chat was created

" } }, "documentation":"

Response structure for creating a new chat

" }, "CreatePrivateConnectionInput":{ "type":"structure", "required":[ "name", "mode" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

Unique name for this Private Connection within the account.

" }, "mode":{ "shape":"PrivateConnectionMode", "documentation":"

Private Connection mode configuration.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags to add to the Private Connection at creation time.

" } }, "documentation":"

Input for creating a new Private Connection.

" }, "CreatePrivateConnectionOutput":{ "type":"structure", "required":[ "name", "type", "status" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

" }, "type":{ "shape":"PrivateConnectionType", "documentation":"

The type of the Private Connection.

" }, "resourceGatewayId":{ "shape":"ResourceGatewayArn", "documentation":"

The service-managed Resource Gateway ARN. Only present for service-managed Private Connections.

" }, "hostAddress":{ "shape":"IpAddressOrDnsName", "documentation":"

IP address or DNS name of the target resource. Only present for service-managed Private Connections.

" }, "vpcId":{ "shape":"VpcId", "documentation":"

VPC identifier of the service-managed Resource Gateway. Only present for service-managed Private Connections.

" }, "resourceConfigurationId":{ "shape":"ResourceConfigurationArn", "documentation":"

The Resource Configuration ARN. Only present for self-managed Private Connections.

" }, "status":{ "shape":"PrivateConnectionStatus", "documentation":"

The status of the Private Connection.

" }, "certificateExpiryTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The expiry time of the certificate associated with the Private Connection. Only present when a certificate is associated.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the created Private Connection.

" } }, "documentation":"

Output containing the newly created Private Connection summary.

" }, "DatadogAuthorizationConfig":{ "type":"structure", "members":{ "authorizationDiscovery":{ "shape":"MCPServerAuthorizationDiscoveryConfig", "documentation":"

Datadog MCP server authorization discovery configuration.

" } }, "documentation":"

Authorization configuration for Datadog MCP server (uses authorization discovery only).

", "union":true }, "DatadogServiceDetails":{ "type":"structure", "required":[ "name", "endpoint", "authorizationConfig" ], "members":{ "name":{ "shape":"DatadogServiceDetailsNameString", "documentation":"

MCP server name.

" }, "endpoint":{ "shape":"DatadogServiceDetailsEndpointString", "documentation":"

MCP server endpoint URL.

" }, "description":{ "shape":"DatadogServiceDetailsDescriptionString", "documentation":"

Optional description for the MCP server.

" }, "authorizationConfig":{ "shape":"DatadogAuthorizationConfig", "documentation":"

Datadog MCP server authorization configuration (only authorization discovery is supported).

" } }, "documentation":"

Complete service details for Datadog MCP server integration.

" }, "DatadogServiceDetailsDescriptionString":{ "type":"string", "documentation":"

Description field

", "max":500, "min":0, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+", "sensitive":true }, "DatadogServiceDetailsEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "DatadogServiceDetailsNameString":{ "type":"string", "pattern":"[a-zA-Z0-9_-]+" }, "DateTime":{ "type":"timestamp", "timestampFormat":"iso8601" }, "DeleteAgentSpaceInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" } }, "documentation":"

Input for deleting an AgentSpace.

" }, "DeleteAgentSpaceOutput":{ "type":"structure", "members":{}, "documentation":"

Empty output for successful AgentSpace deletion.

" }, "DeletePrivateConnectionInput":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

", "location":"uri", "locationName":"name" } }, "documentation":"

Input for deleting an existing Private Connection.

" }, "DeletePrivateConnectionOutput":{ "type":"structure", "required":[ "name", "status" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

" }, "status":{ "shape":"PrivateConnectionStatus", "documentation":"

The status of the Private Connection.

" } }, "documentation":"

Output containing the status of the Private Connection deletion.

" }, "DeregisterServiceInput":{ "type":"structure", "required":["serviceId"], "members":{ "serviceId":{ "shape":"ServiceId", "documentation":"

The service id to deregister. A service can only be deregistered if it is not associated with any AgentSpace.

", "location":"uri", "locationName":"serviceId" } }, "documentation":"

Input for deregistering a service.

" }, "DeregisterServiceOutput":{ "type":"structure", "members":{}, "documentation":"

Empty output for successful service deregistration.

" }, "DescribePrivateConnectionInput":{ "type":"structure", "required":["name"], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

", "location":"uri", "locationName":"name" } }, "documentation":"

Input for describing an existing Private Connection.

" }, "DescribePrivateConnectionOutput":{ "type":"structure", "required":[ "name", "type", "status" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

" }, "type":{ "shape":"PrivateConnectionType", "documentation":"

The type of the Private Connection.

" }, "resourceGatewayId":{ "shape":"ResourceGatewayArn", "documentation":"

The service-managed Resource Gateway ARN. Only present for service-managed Private Connections.

" }, "hostAddress":{ "shape":"IpAddressOrDnsName", "documentation":"

IP address or DNS name of the target resource. Only present for service-managed Private Connections.

" }, "vpcId":{ "shape":"VpcId", "documentation":"

VPC identifier of the service-managed Resource Gateway. Only present for service-managed Private Connections.

" }, "resourceConfigurationId":{ "shape":"ResourceConfigurationArn", "documentation":"

The Resource Configuration ARN. Only present for self-managed Private Connections.

" }, "status":{ "shape":"PrivateConnectionStatus", "documentation":"

The status of the Private Connection.

" }, "certificateExpiryTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The expiry time of the certificate associated with the Private Connection. Only present when a certificate is associated.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the Private Connection.

" } }, "documentation":"

Output containing the Private Connection details.

" }, "Description":{ "type":"string", "documentation":"

Description field

", "max":1000, "min":1, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+", "sensitive":true }, "DisableOperatorAppInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "authFlow":{ "shape":"AuthFlow", "documentation":"

The authentication flow configured for the operator App. e.g. idc

", "location":"header", "locationName":"x-amzn-app-auth-flow" } }, "documentation":"

Input for disabling the Operator App for an AgentSpace.

" }, "DisassociateServiceInput":{ "type":"structure", "required":[ "agentSpaceId", "associationId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "associationId":{ "shape":"AssociationId", "documentation":"

The unique identifier of the given association.

", "location":"uri", "locationName":"associationId" } }, "documentation":"

Input for removing a service association from an AgentSpace.

" }, "DisassociateServiceOutput":{ "type":"structure", "members":{}, "documentation":"

Empty output for successful service disassociation.

" }, "Document":{ "type":"structure", "members":{}, "document":true }, "DocumentList":{ "type":"list", "member":{"shape":"Document"}, "documentation":"

Generic list of document objects for flexible data structures.

" }, "Double":{ "type":"double", "box":true }, "DynatraceConfiguration":{ "type":"structure", "required":["envId"], "members":{ "envId":{ "shape":"String", "documentation":"

Dynatrace environment id

" }, "resources":{ "shape":"DynatraceResourceList", "documentation":"

List of Dynatrace resources to monitor

" } }, "documentation":"

Configuration for Dynatrace monitoring integration.

" }, "DynatraceOAuthClientCredentialsConfig":{ "type":"structure", "required":[ "clientId", "clientSecret" ], "members":{ "clientName":{ "shape":"DynatraceOAuthClientCredentialsConfigClientNameString", "documentation":"

User friendly OAuth client name specified by end user.

" }, "clientId":{ "shape":"ClientId", "documentation":"

OAuth client ID for authenticating with the service.

" }, "exchangeParameters":{ "shape":"ExchangeParameters", "documentation":"

OAuth token exchange parameters for authenticating with the service.

" }, "clientSecret":{ "shape":"ClientSecret", "documentation":"

OAuth client secret for authenticating with the service.

" } }, "documentation":"

OAuth client credentials configuration for Dynatrace.

" }, "DynatraceOAuthClientCredentialsConfigClientNameString":{ "type":"string", "max":100, "min":1, "pattern":"[\\p{L}\\p{N}\\p{Z}._-]+" }, "DynatraceResourceList":{ "type":"list", "member":{"shape":"String"}, "documentation":"

List of Dynatrace resources to monitor.

" }, "DynatraceServiceAuthorizationConfig":{ "type":"structure", "members":{ "oAuthClientCredentials":{ "shape":"DynatraceOAuthClientCredentialsConfig", "documentation":"

OAuth client credentials configuration.

" } }, "documentation":"

Authorization configuration options for Dynatrace service.

", "sensitive":true, "union":true }, "DynatraceServiceDetails":{ "type":"structure", "required":["accountUrn"], "members":{ "accountUrn":{ "shape":"DynatraceServiceDetailsAccountUrnString", "documentation":"

Dynatrace resource account urn.

" }, "authorizationConfig":{ "shape":"DynatraceServiceAuthorizationConfig", "documentation":"

Dynatrace OAuth client credentials configuration. Use this when registering with OAuth client credentials flow.

" } }, "documentation":"

Complete service details for Dynatrace integration.

" }, "DynatraceServiceDetailsAccountUrnString":{ "type":"string", "max":255, "min":1, "pattern":"urn:dtaccount:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" }, "EmailAddress":{ "type":"string", "documentation":"

Email address

", "pattern":"[a-zA-Z0-9._%+\\-]+@[a-zA-Z0-9.\\-]+\\.[a-zA-Z]{2,}", "sensitive":true }, "EnableOperatorAppInput":{ "type":"structure", "required":[ "agentSpaceId", "authFlow", "operatorAppRoleArn" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "authFlow":{ "shape":"AuthFlow", "documentation":"

The authentication flow configured for the operator App. e.g. iam or idc

" }, "operatorAppRoleArn":{ "shape":"RoleArn", "documentation":"

The IAM role end users assume to access AIDevOps APIs

" }, "idcInstanceArn":{ "shape":"String", "documentation":"

The IdC instance Arn used to create an IdC auth application

" }, "issuerUrl":{ "shape":"String", "documentation":"

The OIDC issuer URL of the external Identity Provider

" }, "idpClientId":{ "shape":"IdpClientId", "documentation":"

The OIDC client ID for the IdP application

" }, "idpClientSecret":{ "shape":"IdpClientSecret", "documentation":"

The OIDC client secret for the IdP application

" }, "provider":{ "shape":"String", "documentation":"

The Identity Provider name (e.g., Entra, Okta, Google)

" } }, "documentation":"

Input for enabling the Operator App for an AgentSpace.

" }, "EnableOperatorAppOutput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

" }, "iam":{"shape":"IamAuthConfiguration"}, "idc":{"shape":"IdcAuthConfiguration"}, "idp":{"shape":"IdpAuthConfiguration"} }, "documentation":"

Output containing the enabled Operator App configuration.

" }, "EventChannelConfiguration":{ "type":"structure", "members":{}, "documentation":"

Configuration for Event Channel integration.

" }, "EventChannelDetails":{ "type":"structure", "members":{ "type":{ "shape":"EventChannelType", "documentation":"

The type of event channel

" } }, "documentation":"

Service details for Event Channel integration.

" }, "EventChannelType":{ "type":"string", "documentation":"

Event Channel type

", "enum":["webhook"] }, "ExchangeParameterValue":{ "type":"string", "documentation":"

Exchange Parameter value for MCP authentication

", "sensitive":true }, "ExchangeParameters":{ "type":"map", "key":{"shape":"String"}, "value":{"shape":"ExchangeParameterValue"}, "documentation":"

Exchange Parameter Map for MCP authentication.

" }, "Execution":{ "type":"structure", "required":[ "agentSpaceId", "executionId", "agentSubTask", "createdAt", "updatedAt", "executionStatus" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"

The unique identifier for the agent space containing this execution

" }, "executionId":{ "shape":"String", "documentation":"

The unique identifier for this execution

" }, "parentExecutionId":{ "shape":"String", "documentation":"

The identifier of the parent execution, if this is a child execution

" }, "agentSubTask":{ "shape":"String", "documentation":"

The specific subtask being executed by the agent

" }, "createdAt":{ "shape":"JournalTimestamp", "documentation":"

Timestamp when this execution was created

" }, "updatedAt":{ "shape":"JournalTimestamp", "documentation":"

Timestamp when this execution was last updated

" }, "executionStatus":{ "shape":"ExecutionStatus", "documentation":"

The current status of this execution

" }, "agentType":{ "shape":"String", "documentation":"

The type of agent that performed this execution.

" }, "uid":{ "shape":"String", "documentation":"

The unique identifier for the user session associated with this execution

" } }, "documentation":"

Represents an execution instance with its lifecycle information

" }, "ExecutionList":{ "type":"list", "member":{"shape":"Execution"}, "documentation":"

List of execution instances

" }, "ExecutionStatus":{ "type":"string", "documentation":"

Possible states of an execution

", "enum":[ "FAILED", "RUNNING", "STOPPED", "CANCELED", "TIMED_OUT" ] }, "GenericWebhook":{ "type":"structure", "members":{ "webhookUrl":{ "shape":"String", "documentation":"

The webhook URL endpoint

" }, "webhookId":{ "shape":"String", "documentation":"

The unique webhook identifier

" }, "webhookType":{ "shape":"WebhookType", "documentation":"

The webhook authentication type

" }, "webhookSecret":{ "shape":"WebhookSecret", "documentation":"

The webhook secret for authentication

" }, "apiKey":{ "shape":"ApiKeyValue", "documentation":"

API Key for API Key webhook authentication

" } }, "documentation":"

Generic webhook configuration for services that support webhook notifications.

" }, "GetAccountUsageInput":{ "type":"structure", "members":{} }, "GetAccountUsageOutput":{ "type":"structure", "required":[ "usagePeriodStartTime", "usagePeriodEndTime" ], "members":{ "monthlyAccountInvestigationHours":{ "shape":"UsageMetric", "documentation":"

Monthly investigation hours usage and limit for an account

" }, "monthlyAccountEvaluationHours":{ "shape":"UsageMetric", "documentation":"

Monthly evaluation hours usage and limit for an account

" }, "monthlyAccountSystemLearningHours":{ "shape":"UsageMetric", "documentation":"

Monthly system learning hours usage and limit for an account

" }, "monthlyAccountOnDemandHours":{ "shape":"UsageMetric", "documentation":"

Monthly on-demand hours usage and limit for an account

" }, "usagePeriodStartTime":{ "shape":"DateTime", "documentation":"

The start time of the usage tracking period

" }, "usagePeriodEndTime":{ "shape":"DateTime", "documentation":"

The end time of the usage tracking period

" } } }, "GetAgentSpaceInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" } }, "documentation":"

Input for retrieving a specific AgentSpace by ID.

" }, "GetAgentSpaceOutput":{ "type":"structure", "required":["agentSpace"], "members":{ "agentSpace":{"shape":"AgentSpace"}, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the AgentSpace.

" } }, "documentation":"

Output containing the requested AgentSpace details.

" }, "GetAssociationInput":{ "type":"structure", "required":[ "agentSpaceId", "associationId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "associationId":{ "shape":"AssociationId", "documentation":"

The unique identifier of the given association.

", "location":"uri", "locationName":"associationId" } }, "documentation":"

Input for retrieving a specific service association.

" }, "GetAssociationOutput":{ "type":"structure", "required":["association"], "members":{ "association":{"shape":"Association"} }, "documentation":"

Output containing the requested association details.

" }, "GetBacklogTaskRequest":{ "type":"structure", "required":[ "agentSpaceId", "taskId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the task

", "location":"uri", "locationName":"agentSpaceId" }, "taskId":{ "shape":"ResourceId", "documentation":"

The unique identifier of the task to retrieve

", "location":"uri", "locationName":"taskId" } }, "documentation":"

Request structure for retrieving a specific backlog task

" }, "GetBacklogTaskResponse":{ "type":"structure", "required":["task"], "members":{ "task":{ "shape":"Task", "documentation":"

The requested task object

" } }, "documentation":"

Response structure containing the requested backlog task

" }, "GetOperatorAppInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" } }, "documentation":"

Input for retrieving Operator App configuration.

" }, "GetOperatorAppOutput":{ "type":"structure", "members":{ "iam":{"shape":"IamAuthConfiguration"}, "idc":{"shape":"IdcAuthConfiguration"}, "idp":{"shape":"IdpAuthConfiguration"} }, "documentation":"

Output containing the Operator App configuration including authentication details.

" }, "GetRecommendationRequest":{ "type":"structure", "required":[ "agentSpaceId", "recommendationId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the recommendation

", "location":"uri", "locationName":"agentSpaceId" }, "recommendationId":{ "shape":"ResourceId", "documentation":"

The unique identifier for the recommendation to retrieve

", "location":"uri", "locationName":"recommendationId" }, "recommendationVersion":{ "shape":"Long", "documentation":"

Specific version of the recommendation to retrieve. If not specified, returns the latest version.

", "location":"querystring", "locationName":"recommendationVersion" } }, "documentation":"

Request structure for retrieving a specific recommendation

" }, "GetRecommendationResponse":{ "type":"structure", "required":["recommendation"], "members":{ "recommendation":{ "shape":"Recommendation", "documentation":"

The requested recommendation

" } }, "documentation":"

Response structure containing the requested recommendation

" }, "GetServiceInput":{ "type":"structure", "required":["serviceId"], "members":{ "serviceId":{ "shape":"ServiceId", "documentation":"

The unique identifier of the given service.

", "location":"uri", "locationName":"serviceId" } }, "documentation":"

Input for retrieving a specific service association.

" }, "GetServiceOutput":{ "type":"structure", "required":["service"], "members":{ "service":{"shape":"RegisteredService"}, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the Service.

" } }, "documentation":"

Output containing the requested service details.

" }, "GitHubConfiguration":{ "type":"structure", "required":[ "repoName", "repoId", "owner", "ownerType" ], "members":{ "repoName":{ "shape":"String", "documentation":"

Associated Github repo name

" }, "repoId":{ "shape":"String", "documentation":"

Associated Github repo ID

" }, "owner":{ "shape":"String", "documentation":"

The GitHub repository owner name.

" }, "ownerType":{"shape":"GithubRepoOwnerType"}, "instanceIdentifier":{ "shape":"String", "documentation":"

GitHub instance identifier (e.g., github.com or github.enterprise.com)

" } }, "documentation":"

Configuration for GitHub repository integration.

" }, "GitLabConfiguration":{ "type":"structure", "required":[ "projectId", "projectPath" ], "members":{ "projectId":{ "shape":"String", "documentation":"

GitLab numeric project ID.

" }, "projectPath":{ "shape":"String", "documentation":"

Full GitLab project path (e.g., namespace/project-name).

" }, "instanceIdentifier":{ "shape":"String", "documentation":"

GitLab instance identifier (e.g., gitlab.com or e2e.gamma.dev.us-east-1.gitlab.falco.ai.aws.dev)

" } }, "documentation":"

Configuration for GitLab project integration.

" }, "GitLabDetails":{ "type":"structure", "required":[ "targetUrl", "tokenType", "tokenValue" ], "members":{ "targetUrl":{ "shape":"GitLabDetailsTargetUrlString", "documentation":"

GitLab instance URL (e.g., https://gitlab.com or self-hosted instance).

" }, "tokenType":{ "shape":"GitLabTokenType", "documentation":"

Type of GitLab access token

" }, "tokenValue":{ "shape":"GitLabDetailsTokenValueString", "documentation":"

GitLab access token value

" }, "groupId":{ "shape":"String", "documentation":"

Optional GitLab group ID for group-level access tokens

" } }, "documentation":"

Service details for GitLab integration.

" }, "GitLabDetailsTargetUrlString":{ "type":"string", "pattern":"https://[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?(?::[0-9]{1,5})?/?" }, "GitLabDetailsTokenValueString":{ "type":"string", "documentation":"

Token value for authentication.

", "pattern":"[a-zA-Z0-9._-]+", "sensitive":true }, "GitLabTokenType":{ "type":"string", "documentation":"

Type of GitLab access token.

", "enum":[ "personal", "group" ] }, "GithubRepoOwnerType":{ "type":"string", "documentation":"

Type of GitHub repository owner.

", "enum":[ "organization", "user" ] }, "Goal":{ "type":"structure", "required":[ "agentSpaceArn", "goalId", "title", "content", "status", "goalType", "createdAt", "updatedAt", "version" ], "members":{ "agentSpaceArn":{ "shape":"String", "documentation":"

The unique identifier for the agent space containing this goal

" }, "goalId":{ "shape":"String", "documentation":"

The unique identifier for this goal

" }, "title":{ "shape":"String", "documentation":"

The title of the goal

" }, "content":{ "shape":"GoalContent", "documentation":"

Content of the goal

" }, "status":{ "shape":"GoalStatus", "documentation":"

Current status of the goal itself

" }, "goalType":{ "shape":"GoalType", "documentation":"

Type of goal based on its origin

" }, "createdAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this goal was created

" }, "updatedAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this goal was last updated

" }, "lastEvaluatedAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when the goal was last evaluated

" }, "lastTaskId":{ "shape":"String", "documentation":"

ID of the most recent task associated with this goal

" }, "lastSuccessfulTaskId":{ "shape":"String", "documentation":"

ID of the most recent successful task associated with this goal

" }, "version":{ "shape":"Integer", "documentation":"

Version number for optimistic locking

" }, "evaluationSchedule":{ "shape":"GoalSchedule", "documentation":"

Goal Schedule. Allows to schedule the goal to run periodically, as well as disable a goal temporarily

" } }, "documentation":"

Represents a goal with all its properties and metadata

" }, "GoalContent":{ "type":"structure", "required":[ "description", "objectives" ], "members":{ "description":{ "shape":"String", "documentation":"

A detailed description of the goal.

" }, "objectives":{ "shape":"String", "documentation":"

The objectives to be achieved for this goal.

" } }, "documentation":"

Content of a goal

" }, "GoalList":{ "type":"list", "member":{"shape":"Goal"}, "documentation":"

List of goals

" }, "GoalSchedule":{ "type":"structure", "required":["state"], "members":{ "state":{ "shape":"SchedulerState", "documentation":"

Whether the schedule is enabled or disabled

" }, "expression":{ "shape":"String", "documentation":"

Schedule expression (e.g., 'rate(7 days)')

" } }, "documentation":"

Schedule configuration for goal evaluations

" }, "GoalScheduleInput":{ "type":"structure", "required":["state"], "members":{ "state":{ "shape":"SchedulerState", "documentation":"

Whether the schedule is enabled or disabled

" } }, "documentation":"

Schedule configuration for updating goal evaluations

" }, "GoalStatus":{ "type":"string", "documentation":"

Possible states of a goal throughout its lifecycle

", "enum":[ "ACTIVE", "PAUSED", "COMPLETE" ] }, "GoalType":{ "type":"string", "documentation":"

Type of goal based on its origin

", "enum":[ "CUSTOMER_DEFINED", "ONCALL_REPORT" ] }, "GrafanaServiceDetails":{ "type":"structure", "required":[ "name", "endpoint", "authorizationConfig" ], "members":{ "name":{ "shape":"GrafanaServiceDetailsNameString", "documentation":"

MCP server name.

" }, "endpoint":{ "shape":"GrafanaServiceDetailsEndpointString", "documentation":"

MCP server endpoint URL.

" }, "description":{ "shape":"GrafanaServiceDetailsDescriptionString", "documentation":"

Optional description for the MCP server.

" }, "authorizationConfig":{ "shape":"MCPServerAuthorizationConfig", "documentation":"

Grafana MCP server authorization configuration (experimental).

" } }, "documentation":"

Complete service details for Grafana MCP server integration.

" }, "GrafanaServiceDetailsDescriptionString":{ "type":"string", "documentation":"

Description field

", "max":500, "min":0, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+", "sensitive":true }, "GrafanaServiceDetailsEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "GrafanaServiceDetailsNameString":{ "type":"string", "pattern":"[a-zA-Z0-9_-]+" }, "Guid":{ "type":"string", "documentation":"

Globally Unique Identifier (GUID) in standard format.

", "max":36, "min":0, "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" }, "IamAuthConfiguration":{ "type":"structure", "required":[ "operatorAppRoleArn", "createdAt" ], "members":{ "operatorAppRoleArn":{ "shape":"String", "documentation":"

The IAM role end users assume to access AIDevOps APIs

" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IAM auth flow was enabled.

" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IAM auth flow was updated.

" } }, "documentation":"

Configuration for IAM-based authentication flow for the Operator App.

" }, "IdcAuthConfiguration":{ "type":"structure", "required":[ "operatorAppRoleArn", "idcInstanceArn", "createdAt" ], "members":{ "operatorAppRoleArn":{ "shape":"String", "documentation":"

The IAM role end users assume to access AIDevOps APIs

" }, "idcInstanceArn":{ "shape":"String", "documentation":"

The IdC instance Arn used to create an IdC auth application

" }, "idcApplicationArn":{ "shape":"String", "documentation":"

The IdC application Arn created for IdC auth

" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IdC auth flow was enabled.

" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IdC auth flow was updated.

" } }, "documentation":"

Configuration for AWS Identity Center (IdC) authentication flow for the Operator App.

" }, "IdentityCenterServiceException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing why the call fails

" }, "underlyingErrorCode":{ "shape":"String", "documentation":"

The Idc error code

" } }, "documentation":"

Calls to the customer Identity Center have failed

", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "IdpAuthConfiguration":{ "type":"structure", "required":[ "issuerUrl", "clientId", "operatorAppRoleArn", "provider", "createdAt" ], "members":{ "issuerUrl":{ "shape":"String", "documentation":"

The OIDC issuer URL of the external Identity Provider

" }, "clientId":{ "shape":"String", "documentation":"

The OIDC client ID for the IdP application

" }, "operatorAppRoleArn":{ "shape":"String", "documentation":"

The IAM role end users assume to access AIDevOps APIs

" }, "provider":{ "shape":"String", "documentation":"

The Identity Provider name (e.g., Entra, Okta, Google)

" }, "createdAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IdP auth flow was enabled.

" }, "updatedAt":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The timestamp when the Operator App IdP auth flow was updated.

" } }, "documentation":"

Configuration for external Identity Provider OIDC authentication flow for the Operator App.

" }, "IdpClientId":{ "type":"string", "documentation":"

Client ID for IdP OIDC authentication.

", "max":512, "min":1 }, "IdpClientSecret":{ "type":"string", "documentation":"

Client secret for IdP OIDC authentication.

", "max":1024, "min":1, "sensitive":true }, "Integer":{ "type":"integer", "box":true }, "InternalServerException":{ "type":"structure", "required":["message"], "members":{ "message":{"shape":"String"} }, "documentation":"

This exception is thrown when an unexpected error occurs in the processing of a request.

", "error":{"httpStatusCode":500}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "InvalidParameterException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing which parameter is invalid and why.

" } }, "documentation":"

One or more parameters provided in the request are invalid.

", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "IpAddressOrDnsName":{ "type":"string", "documentation":"

IP address or DNS name of a target resource.

", "max":255, "min":3, "pattern":"[a-zA-Z0-9.:\\-]+" }, "IpAddressType":{ "type":"string", "documentation":"

IP address type for a Resource Gateway.

", "enum":[ "IPV4", "IPV6", "DUAL_STACK" ] }, "JournalRecord":{ "type":"structure", "required":[ "agentSpaceId", "executionId", "recordId", "content", "createdAt", "recordType" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"

The unique identifier for the agent space containing this record

" }, "executionId":{ "shape":"String", "documentation":"

The execution ID associated with this journal record

" }, "recordId":{ "shape":"String", "documentation":"

The unique identifier for this journal record

" }, "content":{ "shape":"Document", "documentation":"

The content of this journal record

" }, "createdAt":{ "shape":"JournalTimestamp", "documentation":"

Timestamp when this journal record was created

" }, "recordType":{ "shape":"String", "documentation":"

The type of this journal record

" }, "userReference":{ "shape":"UserReference", "documentation":"

Reference to the user associated with this journal record

" } }, "documentation":"

Represents a journal record containing execution details and content

" }, "JournalRecordList":{ "type":"list", "member":{"shape":"JournalRecord"}, "documentation":"

List of journal records

" }, "JournalTimestamp":{ "type":"timestamp", "documentation":"

Timestamp format used for journal operations

" }, "KmsKeyArn":{ "type":"string", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

", "min":20, "pattern":"arn:aws[a-zA-Z-]*:kms:[a-z0-9-]+:[0-9]{12}:key/[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}" }, "ListAgentSpacesInput":{ "type":"structure", "members":{ "maxResults":{ "shape":"ListAgentSpacesInputMaxResultsInteger", "documentation":"

Maximum number of results to return in a single call.

", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for the next page of results.

", "location":"querystring", "locationName":"nextToken" } }, "documentation":"

Input for listing AgentSpaces with pagination support.

" }, "ListAgentSpacesInputMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListAgentSpacesOutput":{ "type":"structure", "required":["agentSpaces"], "members":{ "nextToken":{ "shape":"NextToken", "documentation":"

Token to retrieve the next page of results, if there are more results.

" }, "agentSpaces":{ "shape":"AgentSpaceList", "documentation":"

The list of AgentSpaces.

" } }, "documentation":"

Output containing a list of AgentSpaces and pagination token.

" }, "ListAssociationsInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "maxResults":{ "shape":"ListAssociationsInputMaxResultsInteger", "documentation":"

Maximum number of results to return in a single call.

", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for the next page of results.

", "location":"querystring", "locationName":"nextToken" }, "filterServiceTypes":{ "shape":"ListAssociationsInputFilterServiceTypesString", "documentation":"

A comma-separated list of service types to filter list associations output

", "location":"querystring", "locationName":"filterServiceTypes" } }, "documentation":"

Input for listing service associations within an AgentSpace.

" }, "ListAssociationsInputFilterServiceTypesString":{ "type":"string", "pattern":"\\w+(?:,\\s*\\w+)*" }, "ListAssociationsInputMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListAssociationsOutput":{ "type":"structure", "required":["associations"], "members":{ "nextToken":{ "shape":"NextToken", "documentation":"

Token to retrieve the next page of results, if there are more results.

" }, "associations":{ "shape":"AssociationsList", "documentation":"

The list of associations.

" } }, "documentation":"

Output containing a list of service associations and pagination token.

" }, "ListBacklogTasksRequest":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the tasks

", "location":"uri", "locationName":"agentSpaceId" }, "filter":{ "shape":"TaskFilter", "documentation":"

Filter criteria to apply when listing tasks

Filtering restrictions:

" }, "limit":{ "shape":"ListBacklogTasksRequestLimitInteger", "documentation":"

Maximum number of tasks to return in a single response (1-1000, default: 100)

" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for retrieving the next page of results

" }, "sortField":{ "shape":"TaskSortField", "documentation":"

Field to sort by

Sorting restrictions: 
" }, "order":{ "shape":"TaskSortOrder", "documentation":"

Sort order for the tasks based on sortField (default: DESC)

" } }, "documentation":"

Request structure for listing backlog tasks with filtering, sorting, and pagination support

" }, "ListBacklogTasksRequestLimitInteger":{ "type":"integer", "box":true, "max":1000, "min":1 }, "ListBacklogTasksResponse":{ "type":"structure", "required":["tasks"], "members":{ "tasks":{ "shape":"TaskList", "documentation":"

List of backlog tasks

" }, "nextToken":{ "shape":"String", "documentation":"

Token for retrieving the next page of results, if more results are available

" } }, "documentation":"

Response structure containing a list of backlog tasks

" }, "ListChatsRequest":{ "type":"structure", "required":[ "agentSpaceId", "userId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "location":"uri", "locationName":"agentSpaceId" }, "userId":{ "shape":"ResourceId", "documentation":"

The user identifier to list chats for

", "location":"querystring", "locationName":"userId" }, "maxResults":{ "shape":"ListChatsRequestMaxResultsInteger", "documentation":"

Maximum number of results to return

", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"String", "documentation":"

Token for pagination

", "location":"querystring", "locationName":"nextToken" } }, "documentation":"

Request structure for listing chats

" }, "ListChatsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":20, "min":1 }, "ListChatsResponse":{ "type":"structure", "required":["executions"], "members":{ "executions":{ "shape":"ChatExecutionList", "documentation":"

List of recent chat executions

" }, "nextToken":{ "shape":"String", "documentation":"

Token for retrieving the next page of results

" } }, "documentation":"

Response structure for listing chats

" }, "ListExecutionsRequest":{ "type":"structure", "required":[ "agentSpaceId", "taskId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space

", "location":"uri", "locationName":"agentSpaceId" }, "taskId":{ "shape":"ResourceId", "documentation":"

The unique identifier of the task whose executions to retrieve

" }, "limit":{ "shape":"Integer", "documentation":"

Maximum number of executions to return

" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for pagination to retrieve the next set of results

" } }, "documentation":"

Request structure for listing executions

" }, "ListExecutionsResponse":{ "type":"structure", "required":["executions"], "members":{ "executions":{ "shape":"ExecutionList", "documentation":"

List of executions

" }, "nextToken":{ "shape":"String", "documentation":"

Token for retrieving the next page of results, if available

" } }, "documentation":"

Response structure containing executions

" }, "ListGoalsRequest":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space

", "location":"uri", "locationName":"agentSpaceId" }, "status":{ "shape":"GoalStatus", "documentation":"

Filter goals by goal status

" }, "goalType":{ "shape":"GoalType", "documentation":"

Filter goals by goal type

" }, "limit":{ "shape":"ListGoalsRequestLimitInteger", "documentation":"

Maximum number of goals to return

" }, "nextToken":{ "shape":"NextToken", "documentation":"

Pagination token for the next set of results

" } }, "documentation":"

Request structure for listing goals

" }, "ListGoalsRequestLimitInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListGoalsResponse":{ "type":"structure", "required":["goals"], "members":{ "goals":{ "shape":"GoalList", "documentation":"

List of goals matching the criteria

" }, "nextToken":{ "shape":"String", "documentation":"

Pagination token for the next set of results

" } }, "documentation":"

Response structure containing the list of goals

" }, "ListJournalRecordsRequest":{ "type":"structure", "required":[ "agentSpaceId", "executionId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the execution

", "location":"uri", "locationName":"agentSpaceId" }, "executionId":{ "shape":"ResourceId", "documentation":"

The unique identifier of the execution whose journal records to retrieve

" }, "limit":{ "shape":"ListJournalRecordsRequestLimitInteger", "documentation":"

Maximum number of records to return in a single response (1-100, default: 100)

" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for retrieving the next page of results

" }, "recordType":{ "shape":"String", "documentation":"

Filter records by type (empty string returns all types)

" }, "order":{ "shape":"OrderType", "documentation":"

Sort order for the records based on timestamp (default: DESC)

" } }, "documentation":"

Request structure for listing journal records with filtering and pagination support

" }, "ListJournalRecordsRequestLimitInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListJournalRecordsResponse":{ "type":"structure", "required":["records"], "members":{ "records":{ "shape":"JournalRecordList", "documentation":"

List of journal records matching the request criteria

" }, "nextToken":{ "shape":"String", "documentation":"

Token for retrieving the next page of results, if more results are available

" } }, "documentation":"

Response structure containing a list of journal records

" }, "ListOfSecurityGroupIds":{ "type":"list", "member":{"shape":"SecurityGroupId"}, "max":5, "min":1 }, "ListOfSubnetIds":{ "type":"list", "member":{"shape":"SubnetId"}, "max":20, "min":1 }, "ListPendingMessagesRequest":{ "type":"structure", "required":[ "agentSpaceId", "executionId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "location":"uri", "locationName":"agentSpaceId" }, "executionId":{ "shape":"ResourceId", "documentation":"

The unique identifier of the execution whose journal records to retrieve

" } }, "documentation":"

Request structure for listing pending messages with filtering and pagination support

" }, "ListPendingMessagesResponse":{ "type":"structure", "required":[ "agentSpaceId", "executionId", "messages", "createdAt" ], "members":{ "agentSpaceId":{"shape":"AgentSpaceId"}, "executionId":{ "shape":"String", "documentation":"

The unique identifier for the execution.

" }, "messages":{ "shape":"PendingMessages", "documentation":"

The list of pending messages for the execution.

" }, "createdAt":{ "shape":"Timestamp", "documentation":"

Timestamp when the pending messages were created.

" } }, "documentation":"

Response structure containing a list of pending messages

" }, "ListPrivateConnectionsInput":{ "type":"structure", "members":{}, "documentation":"

Input for listing Private Connections in the caller's account.

" }, "ListPrivateConnectionsOutput":{ "type":"structure", "required":["privateConnections"], "members":{ "privateConnections":{ "shape":"PrivateConnectionSummaryList", "documentation":"

The list of Private Connections.

" } }, "documentation":"

Output containing the list of Private Connections.

" }, "ListRecommendationsRequest":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the recommendations

", "location":"uri", "locationName":"agentSpaceId" }, "taskId":{ "shape":"ResourceId", "documentation":"

Optional task ID to filter recommendations by specific task

" }, "goalId":{ "shape":"ResourceId", "documentation":"

Optional goal ID to filter recommendations by specific goal

" }, "status":{ "shape":"RecommendationStatus", "documentation":"

Optional status to filter recommendations by their current status

" }, "priority":{ "shape":"RecommendationPriority", "documentation":"

Optional priority to filter recommendations by priority level

" }, "limit":{ "shape":"ListRecommendationsRequestLimitInteger", "documentation":"

Maximum number of recommendations to return in a single response

" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for retrieving the next page of results

" } }, "documentation":"

Request structure for listing recommendations with filtering and pagination support

" }, "ListRecommendationsRequestLimitInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListRecommendationsResponse":{ "type":"structure", "required":["recommendations"], "members":{ "recommendations":{ "shape":"RecommendationList", "documentation":"

List of recommendations matching the request criteria

" }, "nextToken":{ "shape":"String", "documentation":"

Token for retrieving the next page of results, if more results are available

" } }, "documentation":"

Response structure containing a list of recommendations

" }, "ListServicesInput":{ "type":"structure", "members":{ "maxResults":{ "shape":"ListServicesInputMaxResultsInteger", "documentation":"

Maximum number of results to return in a single call.

", "location":"querystring", "locationName":"maxResults" }, "nextToken":{ "shape":"NextToken", "documentation":"

Token for the next page of results.

", "location":"querystring", "locationName":"nextToken" }, "filterServiceType":{ "shape":"Service", "documentation":"

Optional filter to list only services of a specific type.

", "location":"querystring", "locationName":"filterServiceType" } }, "documentation":"

Input for listing registered services with optional filtering by service type.

" }, "ListServicesInputMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListServicesOutput":{ "type":"structure", "required":["services"], "members":{ "nextToken":{ "shape":"NextToken", "documentation":"

Token to retrieve the next page of results, if there are more results.

" }, "services":{"shape":"RegisteredServicesList"} }, "documentation":"

Output containing a list of registered services and pagination token.

" }, "ListTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"ListTagsForResourceRequestResourceArnString", "documentation":"

The ARN of the resource.

", "location":"uri", "locationName":"resourceArn" } } }, "ListTagsForResourceRequestResourceArnString":{ "type":"string", "pattern":"arn:aws:aidevops:[a-z0-9-]+:\\d{12}:(agentspace|service)/[a-zA-Z0-9-]+" }, "ListTagsForResourceResponse":{ "type":"structure", "required":["tags"], "members":{ "tags":{ "shape":"Tags", "documentation":"

Tags associated with the resource.

" } } }, "ListWebhooksInput":{ "type":"structure", "required":[ "agentSpaceId", "associationId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "associationId":{ "shape":"AssociationId", "documentation":"

The unique identifier of the given association.

", "location":"uri", "locationName":"associationId" } }, "documentation":"

Input for listing service webhooks within an association.

" }, "ListWebhooksOutput":{ "type":"structure", "required":["webhooks"], "members":{ "webhooks":{ "shape":"WebhooksList", "documentation":"

The list of association webhooks.

" } }, "documentation":"

Output containing a list of service association webhooks.

" }, "Locale":{ "type":"string", "documentation":"

A BCP 47 locale identifier for configuring the language used in agent responses.

", "max":35, "min":2, "pattern":"[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*" }, "Long":{ "type":"long", "box":true }, "MCPServerAPIKeyConfig":{ "type":"structure", "required":[ "apiKeyName", "apiKeyValue", "apiKeyHeader" ], "members":{ "apiKeyName":{ "shape":"MCPServerAPIKeyConfigApiKeyNameString", "documentation":"

User friendly API key name specified by end user.

" }, "apiKeyValue":{ "shape":"MCPServerAPIKeyConfigApiKeyValueString", "documentation":"

API key value for authenticating with the service.

" }, "apiKeyHeader":{ "shape":"MCPServerAPIKeyConfigApiKeyHeaderString", "documentation":"

HTTP header name to send the API key in requests to the service.

" } }, "documentation":"

API key configuration for MCP server.

" }, "MCPServerAPIKeyConfigApiKeyHeaderString":{ "type":"string", "pattern":"[a-zA-Z0-9-_]+" }, "MCPServerAPIKeyConfigApiKeyNameString":{ "type":"string", "pattern":"[a-zA-Z0-9_\\s-]+" }, "MCPServerAPIKeyConfigApiKeyValueString":{ "type":"string", "documentation":"

API Key Value for service.

", "min":1, "pattern":"[a-zA-Z0-9+/=._-]+(\\s[a-zA-Z0-9+/=._-]+)?", "sensitive":true }, "MCPServerAuthorizationConfig":{ "type":"structure", "members":{ "oAuthClientCredentials":{ "shape":"MCPServerOAuthClientCredentialsConfig", "documentation":"

MCP server configuration with OAuth client credentials.

" }, "oAuth3LO":{ "shape":"MCPServerOAuth3LOConfig", "documentation":"

MCP server configuration with OAuth 3LO.

" }, "apiKey":{ "shape":"MCPServerAPIKeyConfig", "documentation":"

MCP server configuration with API key authentication.

" }, "bearerToken":{ "shape":"MCPServerBearerTokenConfig", "documentation":"

MCP server configuration with Bearer token (RFC 6750).

" }, "authorizationDiscovery":{ "shape":"MCPServerAuthorizationDiscoveryConfig", "documentation":"

MCP server authorization discovery configuration.

" } }, "documentation":"

Authorization configuration options for MCP server, supporting OAuth, API key, bearer token, and authorization discovery methods.

", "union":true }, "MCPServerAuthorizationDiscoveryConfig":{ "type":"structure", "required":["returnToEndpoint"], "members":{ "returnToEndpoint":{ "shape":"MCPServerAuthorizationDiscoveryConfigReturnToEndpointString", "documentation":"

The endpoint to return to after OAuth flow completes (must be AWS console domain)

" } }, "documentation":"

Authorization discovery configuration for MCP server.

" }, "MCPServerAuthorizationDiscoveryConfigReturnToEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]*\\.(console\\.(aws|aws-dev)|awsc-(integ|preprod)\\.aws)\\.amazon\\.com(/.*)?" }, "MCPServerAuthorizationMethod":{ "type":"string", "documentation":"

Supported authorization methods for MCP servers.

", "enum":[ "oauth-client-credentials", "oauth-3lo", "api-key", "bearer-token" ] }, "MCPServerBearerTokenConfig":{ "type":"structure", "required":[ "tokenName", "tokenValue" ], "members":{ "tokenName":{ "shape":"MCPServerBearerTokenConfigTokenNameString", "documentation":"

User friendly bearer token name specified by end user.

" }, "tokenValue":{ "shape":"MCPServerBearerTokenConfigTokenValueString", "documentation":"

Bearer token value in alphanumeric for authenticating with the service.

" }, "authorizationHeader":{ "shape":"MCPServerBearerTokenConfigAuthorizationHeaderString", "documentation":"

HTTP header name to send the bearer token in requests to the service. Defaults to 'Authorization' per RFC 6750.

" } }, "documentation":"

Bearer token configuration for MCP server (RFC 6750).

" }, "MCPServerBearerTokenConfigAuthorizationHeaderString":{ "type":"string", "pattern":"[a-zA-Z0-9-]+" }, "MCPServerBearerTokenConfigTokenNameString":{ "type":"string", "pattern":"[a-zA-Z0-9_\\s-]+" }, "MCPServerBearerTokenConfigTokenValueString":{ "type":"string", "documentation":"

Token value for authentication.

", "pattern":"[\\S]+", "sensitive":true }, "MCPServerDetails":{ "type":"structure", "required":[ "name", "endpoint", "authorizationConfig" ], "members":{ "name":{ "shape":"MCPServerDetailsNameString", "documentation":"

MCP server name.

" }, "endpoint":{ "shape":"MCPServerDetailsEndpointString", "documentation":"

MCP server endpoint URL.

" }, "description":{ "shape":"MCPServerDetailsDescriptionString", "documentation":"

Optional description for the MCP server.

" }, "authorizationConfig":{ "shape":"MCPServerAuthorizationConfig", "documentation":"

MCP server authorization configuration.

" } }, "documentation":"

Complete service details for MCP server integration.

" }, "MCPServerDetailsDescriptionString":{ "type":"string", "documentation":"

Description field

", "max":500, "min":0, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+", "sensitive":true }, "MCPServerDetailsEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPServerDetailsNameString":{ "type":"string", "pattern":"[a-zA-Z0-9_-]+" }, "MCPServerGrafanaConfiguration":{ "type":"structure", "required":["endpoint"], "members":{ "endpoint":{ "shape":"MCPServerGrafanaConfigurationEndpointString", "documentation":"

Grafana instance URL (e.g., https://your-instance.grafana.net)

" }, "organizationId":{ "shape":"MCPServerGrafanaConfigurationOrganizationIdString", "documentation":"

The Grafana organization ID that can be used.

" }, "tools":{ "shape":"MCPToolsList", "documentation":"

List of MCP tools that can be used.

" } }, "documentation":"

Configuration for Grafana MCP server integration, used with an AWS-hosted MCP server.

" }, "MCPServerGrafanaConfigurationEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPServerGrafanaConfigurationOrganizationIdString":{ "type":"string", "pattern":"[0-9]+" }, "MCPServerNewRelicConfiguration":{ "type":"structure", "required":[ "accountId", "endpoint" ], "members":{ "accountId":{ "shape":"MCPServerNewRelicConfigurationAccountIdString", "documentation":"

New Relic Account ID

" }, "endpoint":{ "shape":"MCPServerNewRelicConfigurationEndpointString", "documentation":"

MCP server endpoint URL (e.g., https://mcp.newrelic.com/mcp/)

" } }, "documentation":"

Mixin for webhook update support.

" }, "MCPServerNewRelicConfigurationAccountIdString":{ "type":"string", "min":6, "pattern":"[0-9]+" }, "MCPServerNewRelicConfigurationEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPServerOAuth3LOConfig":{ "type":"structure", "required":[ "clientId", "returnToEndpoint", "authorizationUrl", "exchangeUrl" ], "members":{ "clientName":{ "shape":"MCPServerOAuth3LOConfigClientNameString", "documentation":"

User friendly OAuth client name specified by end user.

" }, "clientId":{ "shape":"ClientId", "documentation":"

OAuth client ID for authenticating with the service.

" }, "exchangeParameters":{ "shape":"ExchangeParameters", "documentation":"

OAuth token exchange parameters for authenticating with the service.

" }, "returnToEndpoint":{ "shape":"MCPServerOAuth3LOConfigReturnToEndpointString", "documentation":"

The endpoint to return to after OAuth flow completes (must be AWS console domain)

" }, "authorizationUrl":{ "shape":"MCPServerOAuth3LOConfigAuthorizationUrlString", "documentation":"

OAuth authorization URL for 3LO authentication.

" }, "exchangeUrl":{ "shape":"MCPServerOAuth3LOConfigExchangeUrlString", "documentation":"

OAuth token exchange URL.

" }, "clientSecret":{ "shape":"ClientSecret", "documentation":"

OAuth client secret for authenticating with the service. Required for confidential clients or when PKCE is not supported. Optional for public clients using PKCE.

" }, "supportCodeChallenge":{ "shape":"Boolean", "documentation":"

Whether the service supports PKCE (Proof Key for Code Exchange) for enhanced security during the OAuth flow.

" }, "scopes":{ "shape":"Scopes", "documentation":"

OAuth scopes for 3LO authentication. The service will always request scope offline_access.

" } }, "documentation":"

OAuth 3-legged authorization configuration for MCP server.

" }, "MCPServerOAuth3LOConfigAuthorizationUrlString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPServerOAuth3LOConfigClientNameString":{ "type":"string", "max":100, "min":1, "pattern":"[\\p{L}\\p{N}\\p{Z}._-]+" }, "MCPServerOAuth3LOConfigExchangeUrlString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPServerOAuth3LOConfigReturnToEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]*\\.(console\\.(aws|aws-dev)|awsc-(integ|preprod)\\.aws)\\.amazon\\.com(/.*)?" }, "MCPServerOAuthClientCredentialsConfig":{ "type":"structure", "required":[ "clientId", "clientSecret", "exchangeUrl" ], "members":{ "clientName":{ "shape":"MCPServerOAuthClientCredentialsConfigClientNameString", "documentation":"

User friendly OAuth client name specified by end user.

" }, "clientId":{ "shape":"ClientId", "documentation":"

OAuth client ID for authenticating with the service.

" }, "exchangeParameters":{ "shape":"ExchangeParameters", "documentation":"

OAuth token exchange parameters for authenticating with the service.

" }, "clientSecret":{ "shape":"ClientSecret", "documentation":"

OAuth client secret for authenticating with the service.

" }, "exchangeUrl":{ "shape":"MCPServerOAuthClientCredentialsConfigExchangeUrlString", "documentation":"

OAuth token exchange URL.

" }, "scopes":{ "shape":"Scopes", "documentation":"

OAuth scopes for 3LO authentication. The service will always request scope offline_access.

" } }, "documentation":"

OAuth client credentials configuration for MCP server.

" }, "MCPServerOAuthClientCredentialsConfigClientNameString":{ "type":"string", "max":100, "min":1, "pattern":"[\\p{L}\\p{N}\\p{Z}._-]+" }, "MCPServerOAuthClientCredentialsConfigExchangeUrlString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "MCPToolsList":{ "type":"list", "member":{"shape":"MCPToolsListMemberString"}, "documentation":"

List of MCP tool names available for the association.

" }, "MCPToolsListMemberString":{ "type":"string", "pattern":"[a-zA-Z0-9_-]+" }, "MaxIpv4AddressesPerEni":{ "type":"integer", "documentation":"

The number of IPv4 addresses in each ENI for the Resource Gateway.

", "box":true, "max":62, "min":1 }, "Message":{ "type":"structure", "members":{ "userMessage":{ "shape":"UserMessage", "documentation":"

A message from the user.

" }, "assistantMessage":{ "shape":"AssistantMessage", "documentation":"

A message from the assistant.

" } }, "documentation":"

A message in a conversation, either from the user or the assistant.

", "union":true }, "MessageContent":{ "type":"string", "documentation":"

Message content with size constraint

", "max":32768, "min":0 }, "MonitorAccountType":{ "type":"string", "documentation":"

AWS association type for monitoring account.

", "enum":["monitor"] }, "NewRelicAlertPolicyIds":{ "type":"list", "member":{"shape":"NewRelicAlertPolicyIdsMemberString"}, "documentation":"

List of New Relic alert policy IDs

" }, "NewRelicAlertPolicyIdsMemberString":{ "type":"string", "pattern":"[0-9]+" }, "NewRelicApiKeyConfig":{ "type":"structure", "required":[ "apiKey", "accountId", "region" ], "members":{ "apiKey":{ "shape":"NewRelicApiKeyConfigApiKeyString", "documentation":"

New Relic User API Key

" }, "accountId":{ "shape":"NewRelicApiKeyConfigAccountIdString", "documentation":"

New Relic Account ID

" }, "region":{ "shape":"NewRelicRegion", "documentation":"

New Relic region (US or EU)

" }, "applicationIds":{ "shape":"NewRelicApplicationIds", "documentation":"

List of monitored APM application IDs in New Relic

" }, "entityGuids":{ "shape":"NewRelicEntityGuids", "documentation":"

List of globally unique IDs for New Relic resources (apps, hosts, services)

" }, "alertPolicyIds":{ "shape":"NewRelicAlertPolicyIds", "documentation":"

List of alert policy IDs grouping related conditions

" } }, "documentation":"

API key authentication configuration for New Relic service.

" }, "NewRelicApiKeyConfigAccountIdString":{ "type":"string", "pattern":"[0-9]+" }, "NewRelicApiKeyConfigApiKeyString":{ "type":"string", "documentation":"

API Key Value for service.

", "min":1, "pattern":"NRAK-[A-Z0-9]+", "sensitive":true }, "NewRelicApplicationIds":{ "type":"list", "member":{"shape":"NewRelicApplicationIdsMemberString"}, "documentation":"

List of New Relic application IDs

" }, "NewRelicApplicationIdsMemberString":{ "type":"string", "pattern":"[0-9]+" }, "NewRelicEntityGuids":{ "type":"list", "member":{"shape":"NewRelicEntityGuidsMemberString"}, "documentation":"

List of New Relic entity GUIDs

" }, "NewRelicEntityGuidsMemberString":{ "type":"string", "pattern":"[a-zA-Z0-9_.-]+" }, "NewRelicRegion":{ "type":"string", "documentation":"

The NewRelic region (determines API endpoint).

", "enum":[ "US", "EU" ] }, "NewRelicServiceAuthorizationConfig":{ "type":"structure", "members":{ "apiKey":{ "shape":"NewRelicApiKeyConfig", "documentation":"

New Relic API Key authentication (apiKey, accountId, region).

" } }, "documentation":"

Authorization configuration options for New Relic service.

", "union":true }, "NewRelicServiceDetails":{ "type":"structure", "required":["authorizationConfig"], "members":{ "authorizationConfig":{ "shape":"NewRelicServiceAuthorizationConfig", "documentation":"

New Relic MCP server authorization configuration.

" } }, "documentation":"

Complete service details for New Relic integration.

" }, "NextToken":{ "type":"string", "documentation":"

Pagination token for list operations (1-2048 characters)

", "max":2048, "min":1 }, "OAuthAdditionalStepDetails":{ "type":"structure", "required":["authorizationUrl"], "members":{ "authorizationUrl":{ "shape":"String", "documentation":"

The URL to redirect the user to for OAuth authorization.

" } }, "documentation":"

Details for completing OAuth authorization step.

" }, "OrderType":{ "type":"string", "documentation":"

Sort order options for journal operations

", "enum":[ "ASC", "DESC" ] }, "PagerDutyAuthorizationConfig":{ "type":"structure", "members":{ "oAuthClientCredentials":{ "shape":"PagerDutyOAuthClientCredentialsConfig", "documentation":"

OAuth client credentials configuration.

" } }, "documentation":"

Authorization configuration options for PagerDuty service.

", "union":true }, "PagerDutyConfiguration":{ "type":"structure", "required":[ "services", "customerEmail" ], "members":{ "services":{ "shape":"PagerDutyServicesList", "documentation":"

List of Pagerduty service available for the association.

" }, "customerEmail":{ "shape":"EmailAddress", "documentation":"

Email to be used in Pagerduty API header

" } }, "documentation":"

Configuration for Pagerduty integration.

" }, "PagerDutyDetails":{ "type":"structure", "required":[ "scopes", "authorizationConfig" ], "members":{ "scopes":{ "shape":"PagerDutyScopes", "documentation":"

PagerDuty scopes.

" }, "authorizationConfig":{ "shape":"PagerDutyAuthorizationConfig", "documentation":"

PagerDuty authorization configuration

" } }, "documentation":"

Complete service details for PagerDuty integration

" }, "PagerDutyOAuthClientCredentialsConfig":{ "type":"structure", "required":[ "clientId", "clientSecret" ], "members":{ "clientName":{ "shape":"PagerDutyOAuthClientCredentialsConfigClientNameString", "documentation":"

User friendly OAuth client name specified by end user.

" }, "clientId":{ "shape":"ClientId", "documentation":"

OAuth client ID for authenticating with the service.

" }, "exchangeParameters":{ "shape":"ExchangeParameters", "documentation":"

OAuth token exchange parameters for authenticating with the service.

" }, "clientSecret":{ "shape":"ClientSecret", "documentation":"

OAuth client secret for authenticating with the service.

" } }, "documentation":"

OAuth client credentials configuration for PagerDuty.

" }, "PagerDutyOAuthClientCredentialsConfigClientNameString":{ "type":"string", "max":100, "min":1, "pattern":"[\\p{L}\\p{N}\\p{Z}._-]+" }, "PagerDutyScopes":{ "type":"list", "member":{"shape":"String"} }, "PagerDutyScopesList":{ "type":"list", "member":{"shape":"String"}, "documentation":"

PagerDuty list of scopes.

" }, "PagerDutyServicesList":{ "type":"list", "member":{"shape":"String"}, "documentation":"

List of pager duty services available for the association.

" }, "PendingMessage":{ "type":"structure", "required":[ "messageId", "message" ], "members":{ "messageId":{ "shape":"String", "documentation":"

The unique identifier for this pending message.

" }, "message":{ "shape":"Message", "documentation":"

The message content.

" } }, "documentation":"

Represents a pending message in an agent execution.

" }, "PendingMessages":{ "type":"list", "member":{"shape":"PendingMessage"} }, "PortRange":{ "type":"string", "documentation":"

TCP port range expression (single port or range e.g. '443' or '8080-8090'). Valid port values are 1-65535, enforced at runtime.

", "min":1, "pattern":"((\\d{1,5}\\-\\d{1,5})|(\\d+))" }, "PortRanges":{ "type":"list", "member":{"shape":"PortRange"}, "max":11, "min":1 }, "PostRegisterServiceSupportedService":{ "type":"string", "documentation":"

Services that can be registered via the post-registration API (excludes OAuth 3LO services).

", "enum":[ "dynatrace", "servicenow", "pagerduty", "gitlab", "eventChannel", "mcpservernewrelic", "mcpservergrafana", "mcpserverdatadog", "mcpserver", "mcpserversplunk", "azureidentity" ] }, "Priority":{ "type":"string", "documentation":"

Priority levels for tasks, from highest to lowest urgency

", "enum":[ "CRITICAL", "HIGH", "MEDIUM", "LOW", "MINIMAL" ] }, "PrivateConnectionMode":{ "type":"structure", "members":{ "serviceManaged":{ "shape":"ServiceManagedInput", "documentation":"

Service manages the Resource Gateway lifecycle.

" }, "selfManaged":{ "shape":"SelfManagedInput", "documentation":"

Caller manages their own resource configuration.

" } }, "documentation":"

Private Connection mode — either service-managed or self-managed.

", "union":true }, "PrivateConnectionName":{ "type":"string", "documentation":"

Unique name for a Private Connection within an account.

", "max":30, "min":3, "pattern":"[a-z0-9]([a-z0-9-]*[a-z0-9])?" }, "PrivateConnectionStatus":{ "type":"string", "documentation":"

Status of a Private Connection.

", "enum":[ "ACTIVE", "CREATE_IN_PROGRESS", "CREATE_FAILED", "DELETE_IN_PROGRESS", "DELETE_FAILED" ] }, "PrivateConnectionSummary":{ "type":"structure", "required":[ "name", "type", "status" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

" }, "type":{ "shape":"PrivateConnectionType", "documentation":"

The type of the Private Connection.

" }, "resourceGatewayId":{ "shape":"ResourceGatewayArn", "documentation":"

The service-managed Resource Gateway ARN. Only present for service-managed Private Connections.

" }, "hostAddress":{ "shape":"IpAddressOrDnsName", "documentation":"

IP address or DNS name of the target resource. Only present for service-managed Private Connections.

" }, "vpcId":{ "shape":"VpcId", "documentation":"

VPC identifier of the service-managed Resource Gateway. Only present for service-managed Private Connections.

" }, "resourceConfigurationId":{ "shape":"ResourceConfigurationArn", "documentation":"

The Resource Configuration ARN. Only present for self-managed Private Connections.

" }, "status":{ "shape":"PrivateConnectionStatus", "documentation":"

The status of the Private Connection.

" }, "certificateExpiryTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The expiry time of the certificate associated with the Private Connection. Only present when a certificate is associated.

" } }, "documentation":"

Summary of a Private Connection.

" }, "PrivateConnectionSummaryList":{ "type":"list", "member":{"shape":"PrivateConnectionSummary"} }, "PrivateConnectionType":{ "type":"string", "documentation":"

The type of Private Connection.

", "enum":[ "SELF_MANAGED", "SERVICE_MANAGED" ] }, "Recommendation":{ "type":"structure", "required":[ "agentSpaceArn", "recommendationId", "taskId", "title", "content", "status", "priority", "createdAt", "updatedAt", "version" ], "members":{ "agentSpaceArn":{ "shape":"String", "documentation":"

ARN of the agent space this recommendation belongs to

" }, "recommendationId":{ "shape":"String", "documentation":"

The unique identifier for this recommendation

" }, "taskId":{ "shape":"String", "documentation":"

ID of the task that generated the recommendation

" }, "goalId":{ "shape":"String", "documentation":"

ID of the goal this recommendation is associated with

" }, "title":{ "shape":"String", "documentation":"

The title of the recommendation

" }, "content":{ "shape":"RecommendationContent", "documentation":"

Content of the recommendation

" }, "status":{ "shape":"RecommendationStatus", "documentation":"

Current status of the recommendation

" }, "priority":{ "shape":"RecommendationPriority", "documentation":"

Priority level of the recommendation

" }, "goalVersion":{ "shape":"Long", "documentation":"

Version of the goal at the time this recommendation was generated

" }, "additionalContext":{ "shape":"String", "documentation":"

Additional context for recommendation

" }, "createdAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this recommendation was created

" }, "updatedAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this recommendation was last updated

" }, "version":{ "shape":"Long", "documentation":"

Version number for optimistic locking

" } }, "documentation":"

Represents a recommendation with all its properties and metadata

" }, "RecommendationContent":{ "type":"structure", "required":["summary"], "members":{ "summary":{ "shape":"String", "documentation":"

A brief summary of the recommendation.

" }, "spec":{ "shape":"RecommendationContentSpecString", "documentation":"

Agent-ready specification with detailed implementation steps

" } }, "documentation":"

Content of a recommendation

" }, "RecommendationContentSpecString":{ "type":"string", "max":100000, "min":0 }, "RecommendationList":{ "type":"list", "member":{"shape":"Recommendation"} }, "RecommendationPriority":{ "type":"string", "documentation":"

Priority level of a recommendation

", "enum":[ "HIGH", "MEDIUM", "LOW" ] }, "RecommendationStatus":{ "type":"string", "documentation":"

Status of a recommendation

", "enum":[ "PROPOSED", "ACCEPTED", "REJECTED", "CLOSED", "COMPLETED", "UPDATE_IN_PROGRESS" ] }, "ReferenceInput":{ "type":"structure", "required":[ "system", "referenceId", "referenceUrl", "associationId" ], "members":{ "system":{ "shape":"ReferenceInputSystemString", "documentation":"

The name of the external system

" }, "title":{ "shape":"ReferenceInputTitleString", "documentation":"

Optional title for the reference

" }, "referenceId":{ "shape":"ResourceId", "documentation":"

The unique identifier in the external system

" }, "referenceUrl":{ "shape":"ReferenceInputReferenceUrlString", "documentation":"

URL to access the reference in the external system

" }, "associationId":{ "shape":"ResourceId", "documentation":"

Association identifier of the external system

" } }, "documentation":"

Reference information linking a task to external systems - for input with validation

" }, "ReferenceInputReferenceUrlString":{ "type":"string", "max":2048, "min":1 }, "ReferenceInputSystemString":{ "type":"string", "max":256, "min":1 }, "ReferenceInputTitleString":{ "type":"string", "max":512, "min":1 }, "ReferenceOutput":{ "type":"structure", "required":[ "system", "referenceId", "referenceUrl", "associationId" ], "members":{ "system":{ "shape":"String", "documentation":"

The name of the external system

" }, "title":{ "shape":"String", "documentation":"

Optional title for the reference

" }, "referenceId":{ "shape":"String", "documentation":"

The unique identifier in the external system

" }, "referenceUrl":{ "shape":"String", "documentation":"

URL to access the reference in the external system

" }, "associationId":{ "shape":"String", "documentation":"

Association identifier of the external system

" } }, "documentation":"

Reference information linking a task to external systems - for output without validation

" }, "RegisterServiceInput":{ "type":"structure", "required":[ "service", "serviceDetails" ], "members":{ "service":{ "shape":"PostRegisterServiceSupportedService", "location":"uri", "locationName":"service" }, "serviceDetails":{ "shape":"ServiceDetails", "documentation":"

Service-specific authorization configuration parameters

" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

" }, "privateConnectionName":{ "shape":"PrivateConnectionName", "documentation":"

The name of the private connection to use for VPC connectivity.

" }, "name":{ "shape":"ServiceName", "documentation":"

The display name for the service registration.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags to add to the Service at registration time.

" } }, "documentation":"

Input for registering a new service with the platform.

" }, "RegisterServiceOutput":{ "type":"structure", "members":{ "serviceId":{ "shape":"ServiceId", "documentation":"

Service ID - present when registration is complete, absent when additional steps are required

" }, "additionalStep":{ "shape":"AdditionalServiceRegistrationStep", "documentation":"

Indicates if additional steps are required to complete service registration (e.g., 3-legged OAuth)

" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

" }, "tags":{ "shape":"Tags", "documentation":"

Tags associated with the registered Service.

" } }, "documentation":"

Output containing the service ID and any additional steps required for registration.

" }, "RegisteredAzureDevOpsServiceDetails":{ "type":"structure", "required":["organizationName"], "members":{ "organizationName":{ "shape":"String", "documentation":"

The Azure DevOps Organization name associated with the service.

" } }, "documentation":"

Details specific to a registered Azure DevOps service.

" }, "RegisteredAzureIdentityDetails":{ "type":"structure", "required":[ "tenantId", "clientId", "webIdentityRoleArn", "webIdentityTokenAudiences" ], "members":{ "tenantId":{ "shape":"Guid", "documentation":"

The Azure Active Directory tenant ID for the identity.

" }, "clientId":{ "shape":"Guid", "documentation":"

The client ID of the service principal or managed identity used for authentication.

" }, "webIdentityRoleArn":{ "shape":"RoleArn", "documentation":"

The role ARN to be assumed by DevOps Agent for requesting Web Identity Token.

" }, "webIdentityTokenAudiences":{ "shape":"WebIdentityTokenAudienceList", "documentation":"

The audiences for the Web Identity Token.

" } }, "documentation":"

Details specific to a registered Azure identity using AWS Outbound Identity Federation.

" }, "RegisteredGitLabServiceDetails":{ "type":"structure", "required":[ "targetUrl", "tokenType" ], "members":{ "targetUrl":{ "shape":"String", "documentation":"

The GitLab instance URL.

" }, "tokenType":{ "shape":"GitLabTokenType", "documentation":"

Type of GitLab access token

" }, "groupId":{ "shape":"String", "documentation":"

Optional GitLab group ID for group-level access tokens

" } }, "documentation":"

Details specific to a registered GitLab instance.

" }, "RegisteredGithubServiceDetails":{ "type":"structure", "required":[ "owner", "ownerType" ], "members":{ "owner":{ "shape":"String", "documentation":"

The GitHub repository owner name.

" }, "ownerType":{ "shape":"GithubRepoOwnerType", "documentation":"

The GitHub repository owner type.

" }, "targetUrl":{ "shape":"String", "documentation":"

The GitHub Enterprise Server instance URL (absent for github.com).

" } }, "documentation":"

Details specific to a registered GitHub service.

" }, "RegisteredGrafanaServerDetails":{ "type":"structure", "required":[ "endpoint", "authorizationMethod" ], "members":{ "endpoint":{ "shape":"RegisteredGrafanaServerDetailsEndpointString", "documentation":"

Grafana instance URL (e.g., https://your-instance.grafana.net)

" }, "authorizationMethod":{ "shape":"MCPServerAuthorizationMethod", "documentation":"

The authz method used by the MCP server.

" } }, "documentation":"

Details specific to a registered Grafana server, used by the built-in MCP server.

" }, "RegisteredGrafanaServerDetailsEndpointString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?::[0-9]+)?(?:/.*)?" }, "RegisteredMCPServerDetails":{ "type":"structure", "required":[ "name", "endpoint", "authorizationMethod" ], "members":{ "name":{ "shape":"String", "documentation":"

The MCP server name.

" }, "endpoint":{ "shape":"String", "documentation":"

The MCP server endpoint URL.

" }, "authorizationMethod":{ "shape":"MCPServerAuthorizationMethod", "documentation":"

The MCP server uses this authorization method.

" }, "description":{ "shape":"Description", "documentation":"

Optional description for the MCP server.

" }, "apiKeyHeader":{ "shape":"String", "documentation":"

If the MCP server uses API key authentication, these details are provided.

" } }, "documentation":"

Details specific to a registered MCP (Model Context Protocol) server.

" }, "RegisteredNewRelicDetails":{ "type":"structure", "required":[ "accountId", "region" ], "members":{ "accountId":{ "shape":"String", "documentation":"

The NewRelic account ID.

" }, "region":{ "shape":"NewRelicRegion", "documentation":"

The NewRelic region (determines API endpoint).

" }, "description":{ "shape":"Description", "documentation":"

Optional user description.

" } }, "documentation":"

Details specific to a registered NewRelic instance.

" }, "RegisteredPagerDutyDetails":{ "type":"structure", "required":["scopes"], "members":{ "scopes":{ "shape":"PagerDutyScopesList", "documentation":"

The scopes that were assigned to the service

" } }, "documentation":"

Details specific to a registered PagerDuty service.

" }, "RegisteredService":{ "type":"structure", "required":[ "serviceId", "serviceType" ], "members":{ "serviceId":{ "shape":"ServiceId", "documentation":"

The unique identifier of a service.

" }, "serviceType":{ "shape":"Service", "documentation":"

The service type e.g github or dynatrace

" }, "name":{ "shape":"ServiceName", "documentation":"

The display name of the registered service.

" }, "accessibleResources":{ "shape":"DocumentList", "documentation":"

List of accessible resources for this service.

" }, "additionalServiceDetails":{ "shape":"AdditionalServiceDetails", "documentation":"

Additional details specific to the service type.

" }, "kmsKeyArn":{ "shape":"KmsKeyArn", "documentation":"

The ARN of the AWS Key Management Service (AWS KMS) customer managed key that's used to encrypt resources.

" }, "privateConnectionName":{ "shape":"PrivateConnectionName", "documentation":"

The name of the private connection used for VPC connectivity.

" } }, "documentation":"

Represents a registered service with its configuration and accessible resources.

" }, "RegisteredServiceNowDetails":{ "type":"structure", "members":{ "instanceUrl":{ "shape":"ServiceNowInstanceUrl", "documentation":"

The ServiceNow instance url

" } }, "documentation":"

Details specific to a registered ServiceNow instance.

" }, "RegisteredServicesList":{ "type":"list", "member":{"shape":"RegisteredService"}, "documentation":"

List of registered services.

" }, "RegisteredSlackServiceDetails":{ "type":"structure", "required":[ "teamId", "teamName" ], "members":{ "teamId":{ "shape":"String", "documentation":"

The Slack team ID.

" }, "teamName":{ "shape":"String", "documentation":"

The Slack team name.

" } }, "documentation":"

Details specific to a registered Slack workspace.

" }, "ResourceConfigurationArn":{ "type":"string", "documentation":"

Resource Configuration ARN.

", "max":2048, "min":20, "pattern":"arn:[a-z0-9\\-]+:vpc-lattice:[a-zA-Z0-9\\-]+:\\d{12}:resourceconfiguration/rcfg-[0-9a-z]{17}" }, "ResourceGatewayArn":{ "type":"string", "documentation":"

Resource Gateway ARN.

", "max":2048, "min":20, "pattern":"arn:[a-z0-9\\-]+:vpc-lattice:[a-zA-Z0-9\\-]+:\\d{12}:resourcegateway/rgw-[0-9a-z]{17}" }, "ResourceId":{ "type":"string", "documentation":"

Generic resource identifier (allows alphanumeric characters, hyphens, and underscores; 1-128 characters)

", "max":128, "min":1, "pattern":"[a-zA-Z0-9_.-]+" }, "ResourceNotFoundException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing which resource was not found.

" } }, "documentation":"

The requested resource could not be found.

", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "RoleArn":{ "type":"string", "documentation":"

AWS IAM role ARN.

", "max":255, "min":1, "pattern":"arn:aws:iam::\\d{12}:role/[a-zA-Z0-9+=,.@_/-]+" }, "SchedulerState":{ "type":"string", "documentation":"

State of Goal Schedule. Mirrors EventBridge Scheduler State

", "enum":[ "ENABLED", "DISABLED" ] }, "Scopes":{ "type":"list", "member":{"shape":"String"}, "documentation":"

List of OAuth scopes.

" }, "SecurityGroupId":{ "type":"string", "documentation":"

Security group identifier.

", "max":20, "min":11, "pattern":"sg-(([0-9a-z]{8})|([0-9a-z]{17}))" }, "SelfManagedInput":{ "type":"structure", "required":["resourceConfigurationId"], "members":{ "resourceConfigurationId":{ "shape":"ResourceConfigurationArn", "documentation":"

The ARN of the Resource Configuration.

" }, "certificate":{ "shape":"CertificateString", "documentation":"

Certificate for the Private Connection.

" } }, "documentation":"

Configuration for a self-managed Private Connection.

" }, "SendMessageContentBlockDelta":{ "type":"structure", "members":{ "textDelta":{ "shape":"SendMessageTextDelta", "documentation":"

Text delta for text-based content blocks

" }, "jsonDelta":{ "shape":"SendMessageJsonDelta", "documentation":"

JSON delta for structured content blocks

" } }, "documentation":"

Union of possible delta payloads within a content block delta event

", "union":true }, "SendMessageContentBlockDeltaEvent":{ "type":"structure", "members":{ "index":{ "shape":"Integer", "documentation":"

Zero-based index of the content block

" }, "delta":{ "shape":"SendMessageContentBlockDelta", "documentation":"

The incremental content delta

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted for each incremental content delta within a content block

", "event":true }, "SendMessageContentBlockStartEvent":{ "type":"structure", "members":{ "index":{ "shape":"Integer", "documentation":"

Zero-based index of the content block

" }, "type":{ "shape":"String", "documentation":"

The type of content in this block

" }, "id":{ "shape":"String", "documentation":"

Block identifier

" }, "parentId":{ "shape":"String", "documentation":"

Optional parent block ID for nested content blocks (e.g. subagent tool calls)

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted when a new content block starts

", "event":true }, "SendMessageContentBlockStopEvent":{ "type":"structure", "members":{ "index":{ "shape":"Integer", "documentation":"

Zero-based index of the content block

" }, "type":{ "shape":"String", "documentation":"

The type of content in this block

" }, "text":{ "shape":"String", "documentation":"

The accumulated complete content text

" }, "last":{ "shape":"Boolean", "documentation":"

Whether this is the final content block in the response

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted when a content block is complete

", "event":true }, "SendMessageContext":{ "type":"structure", "members":{ "currentPage":{ "shape":"String", "documentation":"

The current page or view the user is on

" }, "lastMessage":{ "shape":"String", "documentation":"

The ID of the last message in the conversation

" }, "userActionResponse":{ "shape":"String", "documentation":"

Response to a UI prompt (not a text conversation message)

" } }, "documentation":"

Context object for additional message metadata

" }, "SendMessageEvents":{ "type":"structure", "members":{ "responseCreated":{ "shape":"SendMessageResponseCreatedEvent", "documentation":"

Emitted when the response is created

" }, "responseInProgress":{ "shape":"SendMessageResponseInProgressEvent", "documentation":"

Emitted while the response is being generated

" }, "responseCompleted":{ "shape":"SendMessageResponseCompletedEvent", "documentation":"

Emitted when the response completes successfully

" }, "responseFailed":{ "shape":"SendMessageResponseFailedEvent", "documentation":"

Emitted when the response fails

" }, "summary":{ "shape":"SendMessageSummaryEvent", "documentation":"

Emitted to provide a summary of agent actions

" }, "heartbeat":{ "shape":"SendMessageHeartbeatEvent", "documentation":"

Heartbeat event sent periodically to keep the connection alive during idle periods

" }, "contentBlockStart":{ "shape":"SendMessageContentBlockStartEvent", "documentation":"

Emitted when a new content block starts

" }, "contentBlockDelta":{ "shape":"SendMessageContentBlockDeltaEvent", "documentation":"

Emitted for each incremental content delta within a content block

" }, "contentBlockStop":{ "shape":"SendMessageContentBlockStopEvent", "documentation":"

Emitted when a content block is complete

" } }, "documentation":"

Event stream for chat message responses using the content block model. Events follow a lifecycle: responseCreated -> responseInProgress -> (contentBlockStart/contentBlockDelta/contentBlockStop events) -> responseCompleted|responseFailed

SendMessage always uses content block mode — legacy per-field events (outputTextDelta, functionCallArgumentsDelta, etc.) are not emitted.

", "eventstream":true }, "SendMessageHeartbeatEvent":{ "type":"structure", "members":{}, "documentation":"

Heartbeat event to keep connection alive

", "event":true }, "SendMessageJsonDelta":{ "type":"structure", "members":{ "partialJson":{ "shape":"String", "documentation":"

Partial JSON string

" } }, "documentation":"

JSON delta containing partial JSON

" }, "SendMessageRequest":{ "type":"structure", "required":[ "agentSpaceId", "executionId", "content", "userId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The agent space identifier

", "location":"uri", "locationName":"agentSpaceId" }, "executionId":{ "shape":"ResourceId", "documentation":"

The execution identifier for the chat session

" }, "content":{ "shape":"MessageContent", "documentation":"

The user message content

" }, "context":{ "shape":"SendMessageContext", "documentation":"

Optional context for the message

" }, "userId":{ "shape":"ResourceId", "documentation":"

Required user identifier

" } }, "documentation":"

Request structure for sending a chat message

" }, "SendMessageResponse":{ "type":"structure", "required":["events"], "members":{ "events":{ "shape":"SendMessageEvents", "documentation":"

The stream of chat message events

" } }, "documentation":"

Response structure for sending chat message events

", "payload":"events" }, "SendMessageResponseCompletedEvent":{ "type":"structure", "members":{ "responseId":{ "shape":"String", "documentation":"

The response ID

" }, "usage":{ "shape":"SendMessageUsageInfo", "documentation":"

Token usage information

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted when the response completes successfully

", "event":true }, "SendMessageResponseCreatedEvent":{ "type":"structure", "members":{ "responseId":{ "shape":"String", "documentation":"

The response ID

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted when the response is created

", "event":true }, "SendMessageResponseFailedEvent":{ "type":"structure", "members":{ "responseId":{ "shape":"String", "documentation":"

The response ID

" }, "errorCode":{ "shape":"String", "documentation":"

Error code

" }, "errorMessage":{ "shape":"String", "documentation":"

Error message

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted when the response fails

", "event":true }, "SendMessageResponseInProgressEvent":{ "type":"structure", "members":{ "responseId":{ "shape":"String", "documentation":"

The response ID

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event emitted while the response is being generated

", "event":true }, "SendMessageSummaryEvent":{ "type":"structure", "members":{ "content":{ "shape":"String", "documentation":"

Summary content

" }, "sequenceNumber":{ "shape":"Integer", "documentation":"

Event sequence number

" } }, "documentation":"

Event summarizing agent actions

", "event":true }, "SendMessageTextDelta":{ "type":"structure", "members":{ "text":{ "shape":"String", "documentation":"

The text fragment

" } }, "documentation":"

Text delta containing a text fragment

" }, "SendMessageUsageInfo":{ "type":"structure", "members":{ "inputTokens":{ "shape":"Integer", "documentation":"

Number of input tokens

" }, "outputTokens":{ "shape":"Integer", "documentation":"

Number of output tokens

" }, "totalTokens":{ "shape":"Integer", "documentation":"

Total tokens used

" } }, "documentation":"

Token usage information

" }, "Service":{ "type":"string", "documentation":"

Enumeration of all supported service types, combining OAuth 3-legged, client credentials, and simple token authentication methods.

", "enum":[ "github", "slack", "azure", "azuredevops", "dynatrace", "servicenow", "pagerduty", "gitlab", "eventChannel", "mcpservernewrelic", "mcpservergrafana", "mcpserverdatadog", "mcpserver", "mcpserversplunk", "azureidentity" ] }, "ServiceConfiguration":{ "type":"structure", "members":{ "sourceAws":{ "shape":"SourceAwsConfiguration", "documentation":"

AWS source account configuration for monitoring resources.

" }, "aws":{ "shape":"AWSConfiguration", "documentation":"

AWS monitor account configuration.

" }, "github":{ "shape":"GitHubConfiguration", "documentation":"

GitHub repository integration configuration.

" }, "slack":{ "shape":"SlackConfiguration", "documentation":"

Slack workspace integration configuration.

" }, "dynatrace":{ "shape":"DynatraceConfiguration", "documentation":"

Dynatrace monitoring integration configuration.

" }, "servicenow":{ "shape":"ServiceNowConfiguration", "documentation":"

ServiceNow instance integration configuration.

" }, "mcpservernewrelic":{ "shape":"MCPServerNewRelicConfiguration", "documentation":"

NewRelic instance integration configuration.

" }, "gitlab":{ "shape":"GitLabConfiguration", "documentation":"

GitLab project integration configuration.

" }, "eventChannel":{ "shape":"EventChannelConfiguration", "documentation":"

Event Channel instance integration configuration.

" }, "azure":{ "shape":"AzureConfiguration", "documentation":"

Azure subscription integration configuration.

" }, "azuredevops":{ "shape":"AzureDevOpsConfiguration", "documentation":"

Azure DevOps project integration configuration.

" }, "mcpservergrafana":{ "shape":"MCPServerGrafanaConfiguration", "documentation":"

Grafana MCP server integration configuration.

" }, "pagerduty":{ "shape":"PagerDutyConfiguration", "documentation":"

PagerDuty integration configuration

" } }, "documentation":"

Union of all supported service configuration types. Each service has its own specific configuration structure.

", "union":true }, "ServiceDetails":{ "type":"structure", "members":{ "dynatrace":{ "shape":"DynatraceServiceDetails", "documentation":"

Dynatrace-specific service details.

" }, "servicenow":{ "shape":"ServiceNowServiceDetails", "documentation":"

ServiceNow-specific service details.

" }, "mcpserverdatadog":{ "shape":"DatadogServiceDetails", "documentation":"

Datadog MCP server-specific service details.

" }, "mcpserver":{ "shape":"MCPServerDetails", "documentation":"

MCP server-specific service details.

" }, "gitlab":{ "shape":"GitLabDetails", "documentation":"

GitLab-specific service details.

" }, "mcpserversplunk":{ "shape":"MCPServerDetails", "documentation":"

Splunk MCP server-specific service details.

" }, "mcpservernewrelic":{ "shape":"NewRelicServiceDetails", "documentation":"

New Relic-specific service details.

" }, "eventChannel":{ "shape":"EventChannelDetails", "documentation":"

Event Channel specific service details.

" }, "mcpservergrafana":{ "shape":"GrafanaServiceDetails", "documentation":"

Datadog MCP server-specific service details.

" }, "pagerduty":{ "shape":"PagerDutyDetails", "documentation":"

PagerDuty specific service details.

" }, "azureidentity":{ "shape":"RegisteredAzureIdentityDetails", "documentation":"

Azure integration with AWS Outbound Identity Federation specific service details.

" } }, "documentation":"

Union of service-specific configuration details for service registration.

", "union":true }, "ServiceId":{ "type":"string", "documentation":"

Unique identifier for a registered service

", "max":255, "min":1, "pattern":"[a-zA-Z0-9_-]+" }, "ServiceManagedInput":{ "type":"structure", "required":[ "hostAddress", "vpcId", "subnetIds" ], "members":{ "hostAddress":{ "shape":"IpAddressOrDnsName", "documentation":"

IP address or DNS name of the target resource.

" }, "vpcId":{ "shape":"VpcId", "documentation":"

VPC to create the service-managed Resource Gateway in.

" }, "subnetIds":{ "shape":"ListOfSubnetIds", "documentation":"

Subnets that the service-managed Resource Gateway will span.

" }, "securityGroupIds":{ "shape":"ListOfSecurityGroupIds", "documentation":"

Security groups to attach to the service-managed Resource Gateway. If not specified, a default security group is created.

" }, "ipAddressType":{ "shape":"IpAddressType", "documentation":"

IP address type of the service-managed Resource Gateway.

" }, "ipv4AddressesPerEni":{ "shape":"MaxIpv4AddressesPerEni", "documentation":"

Number of IPv4 addresses in each ENI for the service-managed Resource Gateway.

" }, "portRanges":{ "shape":"PortRanges", "documentation":"

TCP port ranges that a consumer can use to access the resource.

" }, "certificate":{ "shape":"CertificateString", "documentation":"

Certificate for the Private Connection.

" } }, "documentation":"

Configuration for a service-managed Private Connection.

" }, "ServiceName":{ "type":"string", "documentation":"

The display name for a registered service.

", "max":255, "min":1, "pattern":"[\\p{L}\\p{N}\\p{P}\\p{S}\\p{Z}]+" }, "ServiceNowAuthenticationScopeList":{ "type":"list", "member":{"shape":"String"}, "documentation":"

List of ServiceNow authentication scope.

" }, "ServiceNowConfiguration":{ "type":"structure", "members":{ "instanceId":{ "shape":"String", "documentation":"

ServiceNow instance ID

" }, "authScopes":{ "shape":"ServiceNowAuthenticationScopeList", "documentation":"

Scoped down authentication scopes for fine grained control

" } }, "documentation":"

Configuration for ServiceNow instance integration.

" }, "ServiceNowInstanceUrl":{ "type":"string", "documentation":"

ServiceNow instance URL.

", "max":255, "min":1, "pattern":"https://[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])\\.service-now\\.com/?" }, "ServiceNowOAuthClientCredentialsConfig":{ "type":"structure", "required":[ "clientId", "clientSecret" ], "members":{ "clientName":{ "shape":"ServiceNowOAuthClientCredentialsConfigClientNameString", "documentation":"

User friendly OAuth client name specified by end user.

" }, "clientId":{ "shape":"ClientId", "documentation":"

OAuth client ID for authenticating with the service.

" }, "exchangeParameters":{ "shape":"ExchangeParameters", "documentation":"

OAuth token exchange parameters for authenticating with the service.

" }, "clientSecret":{ "shape":"ClientSecret", "documentation":"

OAuth client secret for authenticating with the service.

" } }, "documentation":"

OAuth client credentials configuration for ServiceNow.

" }, "ServiceNowOAuthClientCredentialsConfigClientNameString":{ "type":"string", "max":100, "min":1, "pattern":"[\\p{L}\\p{N}\\p{Z}._-]+" }, "ServiceNowServiceAuthorizationConfig":{ "type":"structure", "members":{ "oAuthClientCredentials":{ "shape":"ServiceNowOAuthClientCredentialsConfig", "documentation":"

OAuth client credentials configuration.

" } }, "documentation":"

Authorization configuration options for ServiceNow service.

", "union":true }, "ServiceNowServiceDetails":{ "type":"structure", "required":["instanceUrl"], "members":{ "instanceUrl":{ "shape":"ServiceNowInstanceUrl", "documentation":"

ServiceNow instance URL.

" }, "authorizationConfig":{ "shape":"ServiceNowServiceAuthorizationConfig", "documentation":"

ServiceNow OAuth client credentials configuration. Use this when registering with OAuth client credentials flow.

" } }, "documentation":"

Complete service details for ServiceNow integration.

" }, "ServiceQuotaExceededException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing which quota was exceeded.

" } }, "documentation":"

The request would exceed the service quota limit.

", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "SlackChannel":{ "type":"structure", "required":["channelId"], "members":{ "channelName":{ "shape":"String", "documentation":"

Slack channel name

" }, "channelId":{ "shape":"SlackChannelChannelIdString", "documentation":"

Slack channel ID

" } }, "documentation":"

Represents a Slack channel with its ID and optional name.

" }, "SlackChannelChannelIdString":{ "type":"string", "max":16, "min":8, "pattern":"[CGD][A-Z0-9]+" }, "SlackConfiguration":{ "type":"structure", "required":[ "workspaceId", "workspaceName", "transmissionTarget" ], "members":{ "workspaceId":{ "shape":"SlackConfigurationWorkspaceIdString", "documentation":"

Associated Slack workspace ID

" }, "workspaceName":{ "shape":"String", "documentation":"

Associated Slack workspace name

" }, "transmissionTarget":{ "shape":"SlackTransmissionTarget", "documentation":"

Transmission targets for agent notifications

" } }, "documentation":"

Configuration for Slack workspace integration.

" }, "SlackConfigurationWorkspaceIdString":{ "type":"string", "pattern":"[TE][A-Z0-9]+" }, "SlackTransmissionTarget":{ "type":"structure", "required":["opsOncallTarget"], "members":{ "opsOncallTarget":{ "shape":"SlackChannel", "documentation":"

Destination for On-call Agent (Ops1)

" }, "opsSRETarget":{ "shape":"SlackChannel", "documentation":"

Destination for SRE Agent (Ops1.5)

" } }, "documentation":"

Defines Slack channels for different types of agent notifications.

" }, "SourceAccountType":{ "type":"string", "documentation":"

AWS association type for source account.

", "enum":["source"] }, "SourceAwsConfiguration":{ "type":"structure", "required":[ "accountId", "accountType", "assumableRoleArn" ], "members":{ "accountId":{ "shape":"SourceAwsConfigurationAccountIdString", "documentation":"

AWS Account Id corresponding to provided resources.

" }, "accountType":{ "shape":"SourceAccountType", "documentation":"

Account Type 'source' for AIDevOps monitoring.

" }, "assumableRoleArn":{ "shape":"RoleArn", "documentation":"

Role ARN to be assumed by AIDevOps to operate on behalf of customer.

" }, "externalId":{ "shape":"String", "documentation":"

External ID for additional security when assuming the role. Used to prevent the confused deputy problem.

" } }, "documentation":"

Configuration for AWS source account integration. Note: passRole check on 'assumableRoleArn' is not supported.

" }, "SourceAwsConfigurationAccountIdString":{ "type":"string", "pattern":"\\d{12}" }, "String":{"type":"string"}, "SubnetId":{ "type":"string", "documentation":"

Subnet identifier.

", "max":24, "min":15, "pattern":"subnet-(([0-9a-z]{8})|([0-9a-z]{17}))" }, "SyntheticTimestamp_date_time":{ "type":"timestamp", "timestampFormat":"iso8601" }, "TagKey":{ "type":"string", "documentation":"

Tag key string.

", "max":128, "min":1, "pattern":"[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*" }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"}, "documentation":"

List of tag keys.

" }, "TagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"TagResourceRequestResourceArnString", "documentation":"

The ARN of the resource to tag.

", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"Tags", "documentation":"

Tags to add to the resource.

" } } }, "TagResourceRequestResourceArnString":{ "type":"string", "pattern":"arn:aws:aidevops:[a-z0-9-]+:\\d{12}:(agentspace|service)/[a-zA-Z0-9-]+" }, "TagResourceResponse":{ "type":"structure", "members":{} }, "TagValue":{ "type":"string", "documentation":"

Tag value string.

", "max":256, "min":0, "pattern":"[\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*" }, "Tags":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"}, "documentation":"

Map of tag keys to values.

" }, "Task":{ "type":"structure", "required":[ "agentSpaceId", "taskId", "title", "taskType", "priority", "status", "createdAt", "updatedAt", "version" ], "members":{ "agentSpaceId":{ "shape":"String", "documentation":"

The unique identifier for the agent space containing this task

" }, "taskId":{ "shape":"String", "documentation":"

The unique identifier for this task

" }, "executionId":{ "shape":"String", "documentation":"

The execution ID associated with this task, if any

" }, "title":{ "shape":"String", "documentation":"

The title of the task

" }, "description":{ "shape":"String", "documentation":"

Optional detailed description of the task

" }, "reference":{ "shape":"ReferenceOutput", "documentation":"

Optional reference information linking this task to external systems

" }, "taskType":{ "shape":"TaskType", "documentation":"

The type of this task

" }, "priority":{ "shape":"Priority", "documentation":"

The priority level of this task

" }, "status":{ "shape":"TaskStatus", "documentation":"

The current status of this task

" }, "createdAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this task was created

" }, "updatedAt":{ "shape":"BackLogTimestamp", "documentation":"

Timestamp when this task was last updated

" }, "version":{ "shape":"Integer", "documentation":"

Version number for optimistic locking

" }, "supportMetadata":{ "shape":"Document", "documentation":"

Optional support metadata for the task

" }, "metadata":{ "shape":"Document", "documentation":"

Optional metadata for the task

" }, "primaryTaskId":{ "shape":"String", "documentation":"

The task ID of the primary investigation this task is linked to

" }, "statusReason":{ "shape":"String", "documentation":"

Explanation for why the task status was changed (e.g., linked reason)

" }, "hasLinkedTasks":{ "shape":"Boolean", "documentation":"

Indicates if this task has other tasks linked to it

" } }, "documentation":"

Represents a backlog task with all its properties and metadata

" }, "TaskFilter":{ "type":"structure", "members":{ "createdAfter":{ "shape":"BackLogTimestamp", "documentation":"

Filter for tasks created after this timestamp inclusive

" }, "createdBefore":{ "shape":"BackLogTimestamp", "documentation":"

Filter for tasks created before this timestamp exclusive

" }, "priority":{ "shape":"TaskFilterPriorityList", "documentation":"

Filter by priority (single value only)

" }, "status":{ "shape":"TaskFilterStatusList", "documentation":"

Filter by status (single value only)

" }, "taskType":{ "shape":"TaskFilterTaskTypeList", "documentation":"

Filter by task type (single value only)

" }, "primaryTaskId":{ "shape":"ResourceId", "documentation":"

Filter by primary task ID to get linked tasks

" } }, "documentation":"

Filter criteria for listing backlog tasks, supporting time range, priority, status, and type filters.

" }, "TaskFilterPriorityList":{ "type":"list", "member":{"shape":"Priority"}, "documentation":"

List of backlog task priorities

", "max":1, "min":1 }, "TaskFilterStatusList":{ "type":"list", "member":{"shape":"TaskStatus"}, "documentation":"

List of backlog task statuses

", "max":1, "min":1 }, "TaskFilterTaskTypeList":{ "type":"list", "member":{"shape":"TaskType"}, "documentation":"

List of backlog task types

", "max":1, "min":1 }, "TaskList":{ "type":"list", "member":{"shape":"Task"}, "documentation":"

List of backlog tasks

" }, "TaskSortField":{ "type":"string", "documentation":"

Fields available for sorting tasks

", "enum":[ "CREATED_AT", "PRIORITY" ] }, "TaskSortOrder":{ "type":"string", "documentation":"

Sort order options

", "enum":[ "ASC", "DESC" ] }, "TaskStatus":{ "type":"string", "documentation":"

Possible states of a task throughout its lifecycle

", "enum":[ "PENDING_TRIAGE", "LINKED", "PENDING_START", "IN_PROGRESS", "PENDING_CUSTOMER_APPROVAL", "COMPLETED", "FAILED", "TIMED_OUT", "CANCELED" ] }, "TaskType":{ "type":"string", "documentation":"

Types of tasks that can be created in the backlog

", "enum":[ "INVESTIGATION", "EVALUATION" ] }, "ThrottlingException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

Detailed error message describing the throttling condition.

" } }, "documentation":"

The request was throttled due to too many requests. Please slow down and try again.

", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true, "retryable":{"throttling":false} }, "Timestamp":{"type":"timestamp"}, "UntagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tagKeys" ], "members":{ "resourceArn":{ "shape":"UntagResourceRequestResourceArnString", "documentation":"

The ARN of the resource to untag.

", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"

Tag keys to remove.

", "location":"querystring", "locationName":"tagKeys" } } }, "UntagResourceRequestResourceArnString":{ "type":"string", "pattern":"arn:aws:aidevops:[a-z0-9-]+:\\d{12}:(agentspace|service)/[a-zA-Z0-9-]+" }, "UntagResourceResponse":{ "type":"structure", "members":{} }, "UpdateAgentSpaceInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "name":{ "shape":"AgentSpaceName", "documentation":"

The updated name of the AgentSpace.

" }, "description":{ "shape":"Description", "documentation":"

The updated description of the AgentSpace.

" }, "locale":{ "shape":"Locale", "documentation":"

The updated locale for the AgentSpace, which determines the language used in agent responses.

" } }, "documentation":"

Input for updating an existing AgentSpace's properties. All fields except agentSpaceId are optional for partial updates.

" }, "UpdateAgentSpaceOutput":{ "type":"structure", "required":["agentSpace"], "members":{ "agentSpace":{"shape":"AgentSpace"} }, "documentation":"

Output containing the updated AgentSpace.

" }, "UpdateAssociationInput":{ "type":"structure", "required":[ "agentSpaceId", "associationId", "configuration" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "associationId":{ "shape":"AssociationId", "documentation":"

The unique identifier of the given association.

", "location":"uri", "locationName":"associationId" }, "configuration":{ "shape":"ServiceConfiguration", "documentation":"

The configuration that directs how AgentSpace interacts with the given service. The entire configuration is replaced on update.

" } }, "documentation":"

Input for updating an existing service association. Present fields are fully replaced; absent fields are left unchanged.

" }, "UpdateAssociationOutput":{ "type":"structure", "required":["association"], "members":{ "association":{"shape":"Association"}, "webhook":{ "shape":"GenericWebhook", "documentation":"

Generic webhook configuration

" } }, "documentation":"

Output containing the updated association and optional webhook configuration.

" }, "UpdateBacklogTaskRequest":{ "type":"structure", "required":[ "agentSpaceId", "taskId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the task

", "location":"uri", "locationName":"agentSpaceId" }, "taskId":{ "shape":"ResourceId", "documentation":"

The unique identifier of the task to update

", "location":"uri", "locationName":"taskId" }, "taskStatus":{ "shape":"TaskStatus", "documentation":"

Updated task status

" }, "clientToken":{ "shape":"String", "documentation":"

Client-provided token for idempotent operations

", "idempotencyToken":true } }, "documentation":"

Request structure for updating a task

" }, "UpdateBacklogTaskResponse":{ "type":"structure", "required":["task"], "members":{ "task":{ "shape":"Task", "documentation":"

The updated task object

" } }, "documentation":"

Response structure containing the updated task

" }, "UpdateGoalRequest":{ "type":"structure", "required":[ "agentSpaceId", "goalId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the goal

", "location":"uri", "locationName":"agentSpaceId" }, "goalId":{ "shape":"String", "documentation":"

The unique identifier of the goal to update

", "location":"uri", "locationName":"goalId" }, "evaluationSchedule":{ "shape":"GoalScheduleInput", "documentation":"

Update goal schedule state

" }, "clientToken":{ "shape":"String", "documentation":"

Client-provided token for idempotent operations

", "idempotencyToken":true } }, "documentation":"

Request structure for updating a goal

" }, "UpdateGoalResponse":{ "type":"structure", "required":["goal"], "members":{ "goal":{ "shape":"Goal", "documentation":"

The updated goal object

" } }, "documentation":"

Response structure containing the updated goal

" }, "UpdateOperatorAppIdpConfigInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" }, "idpClientSecret":{ "shape":"IdpClientSecret", "documentation":"

The OIDC client secret for the IdP application

" } }, "documentation":"

Input for updating the external Identity Provider configuration for the Operator App.

" }, "UpdateOperatorAppIdpConfigOutput":{ "type":"structure", "required":[ "agentSpaceId", "idp" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

" }, "idp":{"shape":"IdpAuthConfiguration"} }, "documentation":"

Output containing the updated IdP configuration.

" }, "UpdatePrivateConnectionCertificateInput":{ "type":"structure", "required":[ "name", "certificate" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

", "location":"uri", "locationName":"name" }, "certificate":{ "shape":"CertificateString", "documentation":"

The new certificate for the Private Connection.

" } }, "documentation":"

Input for updating the certificate of a Private Connection.

" }, "UpdatePrivateConnectionCertificateOutput":{ "type":"structure", "required":[ "name", "type", "status" ], "members":{ "name":{ "shape":"PrivateConnectionName", "documentation":"

The name of the Private Connection.

" }, "type":{ "shape":"PrivateConnectionType", "documentation":"

The type of the Private Connection.

" }, "resourceGatewayId":{ "shape":"ResourceGatewayArn", "documentation":"

The service-managed Resource Gateway ARN. Only present for service-managed Private Connections.

" }, "hostAddress":{ "shape":"IpAddressOrDnsName", "documentation":"

IP address or DNS name of the target resource. Only present for service-managed Private Connections.

" }, "vpcId":{ "shape":"VpcId", "documentation":"

VPC identifier of the service-managed Resource Gateway. Only present for service-managed Private Connections.

" }, "resourceConfigurationId":{ "shape":"ResourceConfigurationArn", "documentation":"

The Resource Configuration ARN. Only present for self-managed Private Connections.

" }, "status":{ "shape":"PrivateConnectionStatus", "documentation":"

The status of the Private Connection.

" }, "certificateExpiryTime":{ "shape":"SyntheticTimestamp_date_time", "documentation":"

The expiry time of the certificate associated with the Private Connection. Only present when a certificate is associated.

" } }, "documentation":"

Output containing the updated Private Connection summary.

" }, "UpdateRecommendationRequest":{ "type":"structure", "required":[ "agentSpaceId", "recommendationId" ], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier for the agent space containing the recommendation

", "location":"uri", "locationName":"agentSpaceId" }, "recommendationId":{ "shape":"ResourceId", "documentation":"

The unique identifier for the recommendation to update

", "location":"uri", "locationName":"recommendationId" }, "status":{ "shape":"RecommendationStatus", "documentation":"

Current status of the recommendation

" }, "additionalContext":{ "shape":"String", "documentation":"

Additional context for recommendation

" }, "clientToken":{ "shape":"String", "documentation":"

A unique token that ensures idempotency of the request

", "idempotencyToken":true } }, "documentation":"

Request structure for updating an existing recommendation

" }, "UpdateRecommendationResponse":{ "type":"structure", "required":["recommendation"], "members":{ "recommendation":{ "shape":"Recommendation", "documentation":"

The updated recommendation

" } }, "documentation":"

Response structure containing the updated recommendation

" }, "UsageMetric":{ "type":"structure", "required":[ "limit", "usage" ], "members":{ "limit":{ "shape":"Integer", "documentation":"

Configured limit for this metric.

" }, "usage":{ "shape":"Double", "documentation":"

Current usage for this metric

" } }, "documentation":"

Represents a usage metric with its configured limit and current usage value.

" }, "UserMessage":{ "type":"list", "member":{"shape":"UserMessageBlock"} }, "UserMessageBlock":{ "type":"structure", "members":{ "text":{ "shape":"String", "documentation":"

Text content from the user.

" }, "toolResult":{ "shape":"Document", "documentation":"

Tool execution result provided by the user.

" } }, "documentation":"

A block of content in a user message.

", "union":true }, "UserReference":{ "type":"structure", "required":[ "userId", "userType" ], "members":{ "userId":{ "shape":"String", "documentation":"

The unique identifier for the user

" }, "userType":{ "shape":"UserType", "documentation":"

The type of user

" } }, "documentation":"

Reference to a user in the system

" }, "UserType":{ "type":"string", "documentation":"

Types of users in the system

", "enum":[ "IAM", "IDC", "IDP" ] }, "ValidateAwsAssociationsInput":{ "type":"structure", "required":["agentSpaceId"], "members":{ "agentSpaceId":{ "shape":"AgentSpaceId", "documentation":"

The unique identifier of the AgentSpace

", "location":"uri", "locationName":"agentSpaceId" } }, "documentation":"

Input for validating an aws association

" }, "ValidateAwsAssociationsOutput":{ "type":"structure", "members":{}, "documentation":"

Empty Output for successful validating an aws association

" }, "ValidationException":{ "type":"structure", "required":["message"], "members":{ "message":{ "shape":"String", "documentation":"

A summary of the validation failure.

" }, "fieldList":{ "shape":"ValidationExceptionFieldList", "documentation":"

A list of specific failures encountered while validating the input. A member can appear in this list more than once if it failed to satisfy multiple constraints.

" } }, "documentation":"

A standard error for input validation failures. This should be thrown by services when a member of the input structure falls outside of the modeled or documented constraints.

", "exception":true }, "ValidationExceptionField":{ "type":"structure", "required":[ "path", "message" ], "members":{ "path":{ "shape":"String", "documentation":"

A JSONPointer expression to the structure member whose value failed to satisfy the modeled constraints.

" }, "message":{ "shape":"String", "documentation":"

A detailed description of the validation failure.

" } }, "documentation":"

Describes one specific validation failure for an input member.

" }, "ValidationExceptionFieldList":{ "type":"list", "member":{"shape":"ValidationExceptionField"} }, "ValidationStatus":{ "type":"string", "documentation":"

Represents the validation state of an association.

", "enum":[ "valid", "invalid", "pending-confirmation" ] }, "VpcId":{ "type":"string", "documentation":"

VPC identifier.

", "max":50, "min":5, "pattern":"vpc-(([0-9a-z]{8})|([0-9a-z]{17}))" }, "WebIdentityTokenAudienceList":{ "type":"list", "member":{"shape":"String"}, "documentation":"

List of audiences for Web Identity Token.

" }, "Webhook":{ "type":"structure", "required":[ "webhookUrl", "webhookId" ], "members":{ "webhookUrl":{ "shape":"WebhookWebhookUrlString", "documentation":"

Webhook endpoint URL.

" }, "webhookType":{ "shape":"WebhookType", "documentation":"

Webhook authentication type.

" }, "webhookId":{ "shape":"WebhookWebhookIdString", "documentation":"

The unique identifier of the Webhook

" } }, "documentation":"

Represents a complete Webhook with all its properties, and unique identifier.

" }, "WebhookSecret":{ "type":"string", "documentation":"

Webhook secret for secure webhook communication.

", "sensitive":true }, "WebhookType":{ "type":"string", "documentation":"

Webhook authentication type.

", "enum":[ "hmac", "apikey", "gitlab", "pagerduty" ] }, "WebhookWebhookIdString":{ "type":"string", "max":255, "min":1 }, "WebhookWebhookUrlString":{ "type":"string", "pattern":"https://[a-zA-Z0-9.-]+(?:/.*)?" }, "WebhooksList":{ "type":"list", "member":{"shape":"Webhook"}, "documentation":"

A list of Association Webhook resources.

" } }, "documentation":"

AWS DevOps Agent is a frontier agent that resolves and proactively prevents incidents, continuously improving reliability and performance. AWS DevOps Agent investigates incidents and identifies operational improvements as an experienced DevOps engineer.

The agent works by:

" }