AWS DevOps Agent Service

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.

GetChat (new) Link ¶

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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier of the agent space that contains the chat execution.

type executionId:

string

param executionId:

[REQUIRED]

The unique identifier of the chat execution to retrieve.

rtype:

dict

returns:

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.

UpdateChat (new) Link ¶

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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier of the agent space that contains the chat execution to update.

type executionId:

string

param executionId:

[REQUIRED]

The unique identifier of the chat execution to update.

type summary:

string

param summary:

The new summary to set for the chat execution.

type archiveStatus:

string

param archiveStatus:

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.

type clientToken:

string

param clientToken:

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.

rtype:

dict

returns:

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.

CreateBacklogTask (updated) Link ¶
Changes (request, response)
Request
{'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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

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

type reference:

dict

param reference:

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

type taskType:

string

param taskType:

[REQUIRED]

The type of task being created

type title:

string

param title:

[REQUIRED]

The title of the backlog task

type description:

string

param description:

Optional detailed description of the task

type priority:

string

param priority:

[REQUIRED]

The priority level of the task

type clientToken:

string

param clientToken:

Client-provided token for idempotent operations

This field is autopopulated if not provided.

rtype:

dict

returns:

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

GetBacklogTask (updated) Link ¶
Changes (response)
{'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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier for the agent space containing the task

type taskId:

string

param taskId:

[REQUIRED]

The unique identifier of the task to retrieve

rtype:

dict

returns:

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

ListBacklogTasks (updated) Link ¶
Changes (request, response)
Request
{'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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier for the agent space containing the tasks

type filter:

dict

param filter:

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

type limit:

integer

param limit:

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

type nextToken:

string

param nextToken:

Token for retrieving the next page of results

type sortField:

string

param sortField:

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)

type order:

string

param order:

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

rtype:

dict

returns:

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

ListChats (updated) Link ¶
Changes (request, response)
Request
{'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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier for the agent space to list chats from.

type userId:

string

param userId:

The user identifier to list chats for. This field is deprecated and will be ignored — the service resolves user identity from the authenticated session.

type maxResults:

integer

param maxResults:

Maximum number of results to return

type nextToken:

string

param nextToken:

Token for pagination

type archiveStatus:

string

param archiveStatus:

The archive status to filter by. Use this parameter to list only archived chat executions or only active ones.

rtype:

dict

returns:

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

UpdateBacklogTask (updated) Link ¶
Changes (response)
{'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'
)
type agentSpaceId:

string

param agentSpaceId:

[REQUIRED]

The unique identifier for the agent space containing the task

type taskId:

string

param taskId:

[REQUIRED]

The unique identifier of the task to update

type taskStatus:

string

param taskStatus:

Updated task status

type clientToken:

string

param clientToken:

Client-provided token for idempotent operations

This field is autopopulated if not provided.

rtype:

dict

returns:

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