2026/11/17 - AWS DevOps Agent Service - 2 new 5 updated api methods
Changes AWS DevOps Agent adds Code Change Risk Analysis capability and task types, and GetChat and UpdateChat operations to rename, archive, and unarchive chats and filter ListChats by archive status.
Retrieves the details of a chat execution, including its execution ID, summary, timestamps, and archive status.
See also: AWS API Documentation
Request Syntax
client.get_chat(
agentSpaceId='string',
executionId='string'
)
string
[REQUIRED]
The unique identifier of the agent space that contains the chat execution.
string
[REQUIRED]
The unique identifier of the chat execution to retrieve.
dict
Response Syntax
{
'executionId': 'string',
'summary': 'string',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'archiveStatus': 'ACTIVE'|'ARCHIVED'
}
Response Structure
(dict) --
executionId (string) --
The unique identifier of the chat execution.
summary (string) --
The summary of the chat execution.
createdAt (datetime) --
The date and time at which the chat execution was created.
updatedAt (datetime) --
The date and time at which the chat execution was last updated.
archiveStatus (string) --
Indicates whether the chat execution is archived or active.
Updates a chat execution. You can use this operation to change the chat execution's summary or to archive or unarchive it.
Archiving a chat execution hides it from the default chat list. Unarchiving a chat execution restores it to the default chat list.
See also: AWS API Documentation
Request Syntax
client.update_chat(
agentSpaceId='string',
executionId='string',
summary='string',
archiveStatus='ACTIVE'|'ARCHIVED',
clientToken='string'
)
string
[REQUIRED]
The unique identifier of the agent space that contains the chat execution to update.
string
[REQUIRED]
The unique identifier of the chat execution to update.
string
The new summary to set for the chat execution.
string
The archive status to set for the chat execution. Use this parameter to archive the chat execution, hiding it from the default chat list, or to unarchive it, restoring it to the default chat list.
string
A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, the service ignores the request, but does not return an error.
This field is autopopulated if not provided.
dict
Response Syntax
{
'executionId': 'string',
'summary': 'string',
'updatedAt': datetime(2015, 1, 1),
'archiveStatus': 'ACTIVE'|'ARCHIVED'
}
Response Structure
(dict) --
executionId (string) --
The unique identifier of the updated chat execution.
summary (string) --
The summary of the chat execution after the update.
updatedAt (datetime) --
The date and time at which the chat execution was last updated.
archiveStatus (string) --
The archive status of the chat execution after the update.
{'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}
Response {'task': {'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}}
Creates a new backlog task in the specified agent space
See also: AWS API Documentation
Request Syntax
client.create_backlog_task(
agentSpaceId='string',
reference={
'system': 'string',
'title': 'string',
'referenceId': 'string',
'referenceUrl': 'string',
'associationId': 'string'
},
taskType='INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
title='string',
description='string',
priority='CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
clientToken='string'
)
string
[REQUIRED]
The unique identifier for the agent space where the task will be created
dict
Optional reference information for the task
system (string) -- [REQUIRED]
The name of the external system
title (string) --
Optional title for the reference
referenceId (string) -- [REQUIRED]
The unique identifier in the external system
referenceUrl (string) -- [REQUIRED]
URL to access the reference in the external system
associationId (string) -- [REQUIRED]
Association identifier of the external system
string
[REQUIRED]
The type of task being created
string
[REQUIRED]
The title of the backlog task
string
Optional detailed description of the task
string
[REQUIRED]
The priority level of the task
string
Client-provided token for idempotent operations
This field is autopopulated if not provided.
dict
Response Syntax
{
'task': {
'agentSpaceId': 'string',
'taskId': 'string',
'executionId': 'string',
'title': 'string',
'description': 'string',
'reference': {
'system': 'string',
'title': 'string',
'referenceId': 'string',
'referenceUrl': 'string',
'associationId': 'string'
},
'taskType': 'INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
'priority': 'CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
'status': 'PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'version': 123,
'supportMetadata': {...}|[...]|123|123.4|'string'|True|None,
'metadata': {...}|[...]|123|123.4|'string'|True|None,
'primaryTaskId': 'string',
'statusReason': 'string',
'hasLinkedTasks': True|False
}
}
Response Structure
(dict) --
Response structure containing the created backlog task
task (dict) --
The newly created task object
agentSpaceId (string) --
The unique identifier for the agent space containing this task
taskId (string) --
The unique identifier for this task
executionId (string) --
The execution ID associated with this task, if any
title (string) --
The title of the task
description (string) --
Optional detailed description of the task
reference (dict) --
Optional reference information linking this task to external systems
system (string) --
The name of the external system
title (string) --
Optional title for the reference
referenceId (string) --
The unique identifier in the external system
referenceUrl (string) --
URL to access the reference in the external system
associationId (string) --
Association identifier of the external system
taskType (string) --
The type of this task
priority (string) --
The priority level of this task
status (string) --
The current status of this task
createdAt (datetime) --
Timestamp when this task was created
updatedAt (datetime) --
Timestamp when this task was last updated
version (integer) --
Version number for optimistic locking
supportMetadata (:ref:`document<document>`) --
Optional support metadata for the task
metadata (:ref:`document<document>`) --
Optional metadata for the task
primaryTaskId (string) --
The task ID of the primary investigation this task is linked to
statusReason (string) --
Explanation for why the task status was changed (e.g., linked reason)
hasLinkedTasks (boolean) --
Indicates if this task has other tasks linked to it
{'task': {'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}}
Gets a backlog task for the specified agent space and task id
See also: AWS API Documentation
Request Syntax
client.get_backlog_task(
agentSpaceId='string',
taskId='string'
)
string
[REQUIRED]
The unique identifier for the agent space containing the task
string
[REQUIRED]
The unique identifier of the task to retrieve
dict
Response Syntax
{
'task': {
'agentSpaceId': 'string',
'taskId': 'string',
'executionId': 'string',
'title': 'string',
'description': 'string',
'reference': {
'system': 'string',
'title': 'string',
'referenceId': 'string',
'referenceUrl': 'string',
'associationId': 'string'
},
'taskType': 'INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
'priority': 'CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
'status': 'PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'version': 123,
'supportMetadata': {...}|[...]|123|123.4|'string'|True|None,
'metadata': {...}|[...]|123|123.4|'string'|True|None,
'primaryTaskId': 'string',
'statusReason': 'string',
'hasLinkedTasks': True|False
}
}
Response Structure
(dict) --
Response structure containing the requested backlog task
task (dict) --
The requested task object
agentSpaceId (string) --
The unique identifier for the agent space containing this task
taskId (string) --
The unique identifier for this task
executionId (string) --
The execution ID associated with this task, if any
title (string) --
The title of the task
description (string) --
Optional detailed description of the task
reference (dict) --
Optional reference information linking this task to external systems
system (string) --
The name of the external system
title (string) --
Optional title for the reference
referenceId (string) --
The unique identifier in the external system
referenceUrl (string) --
URL to access the reference in the external system
associationId (string) --
Association identifier of the external system
taskType (string) --
The type of this task
priority (string) --
The priority level of this task
status (string) --
The current status of this task
createdAt (datetime) --
Timestamp when this task was created
updatedAt (datetime) --
Timestamp when this task was last updated
version (integer) --
Version number for optimistic locking
supportMetadata (:ref:`document<document>`) --
Optional support metadata for the task
metadata (:ref:`document<document>`) --
Optional metadata for the task
primaryTaskId (string) --
The task ID of the primary investigation this task is linked to
statusReason (string) --
Explanation for why the task status was changed (e.g., linked reason)
hasLinkedTasks (boolean) --
Indicates if this task has other tasks linked to it
{'filter': {'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}}
Response {'tasks': {'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}}
Lists backlog tasks in the specified agent space with optional filtering and sorting
See also: AWS API Documentation
Request Syntax
client.list_backlog_tasks(
agentSpaceId='string',
filter={
'createdAfter': datetime(2015, 1, 1),
'createdBefore': datetime(2015, 1, 1),
'priority': [
'CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
],
'status': [
'PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
],
'taskType': [
'INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
],
'primaryTaskId': 'string'
},
limit=123,
nextToken='string',
sortField='CREATED_AT'|'PRIORITY',
order='ASC'|'DESC'
)
string
[REQUIRED]
The unique identifier for the agent space containing the tasks
dict
Filter criteria to apply when listing tasks Filtering restrictions: - Each filter field list is limited to a single value - Filtering by Priority and Status at the same time when not filtering by Type is not permitted - Timestamp filters (createdAfter, createdBefore) can be combined with other filters when not sorting by priority
createdAfter (datetime) --
Filter for tasks created after this timestamp inclusive
createdBefore (datetime) --
Filter for tasks created before this timestamp exclusive
priority (list) --
Filter by priority (single value only)
(string) --
Priority levels for tasks, from highest to lowest urgency
status (list) --
Filter by status (single value only)
(string) --
Possible states of a task throughout its lifecycle
taskType (list) --
Filter by task type (single value only)
(string) --
Types of tasks that can be created in the backlog
primaryTaskId (string) --
Filter by primary task ID to get linked tasks
integer
Maximum number of tasks to return in a single response (1-1000, default: 100)
string
Token for retrieving the next page of results
string
Field to sort by Sorting restrictions: - Only sorting on createdAt is supported when using priority or status filters alone. - Sorting by priority is not supported when using Timestamp filters (createdAfter, createdBefore)
string
Sort order for the tasks based on sortField (default: DESC)
dict
Response Syntax
{
'tasks': [
{
'agentSpaceId': 'string',
'taskId': 'string',
'executionId': 'string',
'title': 'string',
'description': 'string',
'reference': {
'system': 'string',
'title': 'string',
'referenceId': 'string',
'referenceUrl': 'string',
'associationId': 'string'
},
'taskType': 'INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
'priority': 'CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
'status': 'PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'version': 123,
'supportMetadata': {...}|[...]|123|123.4|'string'|True|None,
'metadata': {...}|[...]|123|123.4|'string'|True|None,
'primaryTaskId': 'string',
'statusReason': 'string',
'hasLinkedTasks': True|False
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Response structure containing a list of backlog tasks
tasks (list) --
List of backlog tasks
(dict) --
Represents a backlog task with all its properties and metadata
agentSpaceId (string) --
The unique identifier for the agent space containing this task
taskId (string) --
The unique identifier for this task
executionId (string) --
The execution ID associated with this task, if any
title (string) --
The title of the task
description (string) --
Optional detailed description of the task
reference (dict) --
Optional reference information linking this task to external systems
system (string) --
The name of the external system
title (string) --
Optional title for the reference
referenceId (string) --
The unique identifier in the external system
referenceUrl (string) --
URL to access the reference in the external system
associationId (string) --
Association identifier of the external system
taskType (string) --
The type of this task
priority (string) --
The priority level of this task
status (string) --
The current status of this task
createdAt (datetime) --
Timestamp when this task was created
updatedAt (datetime) --
Timestamp when this task was last updated
version (integer) --
Version number for optimistic locking
supportMetadata (:ref:`document<document>`) --
Optional support metadata for the task
metadata (:ref:`document<document>`) --
Optional metadata for the task
primaryTaskId (string) --
The task ID of the primary investigation this task is linked to
statusReason (string) --
Explanation for why the task status was changed (e.g., linked reason)
hasLinkedTasks (boolean) --
Indicates if this task has other tasks linked to it
nextToken (string) --
Token for retrieving the next page of results, if more results are available
{'archiveStatus': 'ACTIVE | ARCHIVED'}
Response {'executions': {'archiveStatus': 'ACTIVE | ARCHIVED'}}
Retrieves a paginated list of the user's recent chat executions
See also: AWS API Documentation
Request Syntax
client.list_chats(
agentSpaceId='string',
userId='string',
maxResults=123,
nextToken='string',
archiveStatus='ACTIVE'|'ARCHIVED'
)
string
[REQUIRED]
The unique identifier for the agent space to list chats from.
string
The user identifier to list chats for. This field is deprecated and will be ignored — the service resolves user identity from the authenticated session.
integer
Maximum number of results to return
string
Token for pagination
string
The archive status to filter by. Use this parameter to list only archived chat executions or only active ones.
dict
Response Syntax
{
'executions': [
{
'executionId': 'string',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'summary': 'string',
'archiveStatus': 'ACTIVE'|'ARCHIVED'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
Response structure for listing chats
executions (list) --
List of recent chat executions
(dict) --
A single chat execution summary
executionId (string) --
The unique identifier for the execution
createdAt (datetime) --
Timestamp when the chat was created
updatedAt (datetime) --
Timestamp when the chat was last updated
summary (string) --
Summary or title of the chat
archiveStatus (string) --
Indicates whether the chat execution is archived or active.
nextToken (string) --
Token for retrieving the next page of results
{'task': {'taskType': {'CODE_CHANGE_RISK_ANALYSIS'}}}
Update an existing backlog task.
See also: AWS API Documentation
Request Syntax
client.update_backlog_task(
agentSpaceId='string',
taskId='string',
taskStatus='PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
clientToken='string'
)
string
[REQUIRED]
The unique identifier for the agent space containing the task
string
[REQUIRED]
The unique identifier of the task to update
string
Updated task status
string
Client-provided token for idempotent operations
This field is autopopulated if not provided.
dict
Response Syntax
{
'task': {
'agentSpaceId': 'string',
'taskId': 'string',
'executionId': 'string',
'title': 'string',
'description': 'string',
'reference': {
'system': 'string',
'title': 'string',
'referenceId': 'string',
'referenceUrl': 'string',
'associationId': 'string'
},
'taskType': 'INVESTIGATION'|'EVALUATION'|'RELEASE_READINESS_REVIEW'|'RELEASE_TESTING'|'CODE_CHANGE_RISK_ANALYSIS',
'priority': 'CRITICAL'|'HIGH'|'MEDIUM'|'LOW'|'MINIMAL',
'status': 'PENDING_TRIAGE'|'LINKED'|'PENDING_START'|'IN_PROGRESS'|'PENDING_CUSTOMER_APPROVAL'|'COMPLETED'|'FAILED'|'TIMED_OUT'|'CANCELED'|'SKIPPED'|'WAITING',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'version': 123,
'supportMetadata': {...}|[...]|123|123.4|'string'|True|None,
'metadata': {...}|[...]|123|123.4|'string'|True|None,
'primaryTaskId': 'string',
'statusReason': 'string',
'hasLinkedTasks': True|False
}
}
Response Structure
(dict) --
Response structure containing the updated task
task (dict) --
The updated task object
agentSpaceId (string) --
The unique identifier for the agent space containing this task
taskId (string) --
The unique identifier for this task
executionId (string) --
The execution ID associated with this task, if any
title (string) --
The title of the task
description (string) --
Optional detailed description of the task
reference (dict) --
Optional reference information linking this task to external systems
system (string) --
The name of the external system
title (string) --
Optional title for the reference
referenceId (string) --
The unique identifier in the external system
referenceUrl (string) --
URL to access the reference in the external system
associationId (string) --
Association identifier of the external system
taskType (string) --
The type of this task
priority (string) --
The priority level of this task
status (string) --
The current status of this task
createdAt (datetime) --
Timestamp when this task was created
updatedAt (datetime) --
Timestamp when this task was last updated
version (integer) --
Version number for optimistic locking
supportMetadata (:ref:`document<document>`) --
Optional support metadata for the task
metadata (:ref:`document<document>`) --
Optional metadata for the task
primaryTaskId (string) --
The task ID of the primary investigation this task is linked to
statusReason (string) --
Explanation for why the task status was changed (e.g., linked reason)
hasLinkedTasks (boolean) --
Indicates if this task has other tasks linked to it