chats

Creates, updates, deletes, gets or lists a chats resource.

Overview

Name	chats
Type	Resource
Id	aws.devops_agent.chats

Fields

The following fields are returned by SELECT queries:

list_chats

Name	Datatype	Description
executions	array	List of recent chat executions
next_token	string	Token for retrieving the next page of results

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_chats	select	agent_space_id, region	userId, maxResults, nextToken	Retrieves a paginated list of the user's recent chat executions
create_chat	insert	agent_space_id, region	userId, userType	Creates a new chat execution in the specified agent space

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
agent_space_id	string
region	string	AWS region (default: us-east-1)
maxResults	integer	Maximum number of results to return
nextToken	string	Token for pagination
userId	string	The user identifier for the chat. This field is deprecated and will be ignored — the service resolves user identity from the authenticated session.
userType	string	The authentication type of the user

SELECT examples

list_chats

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

SELECT
executions,
next_token
FROM aws.devops_agent.chats
WHERE agent_space_id = '{{ agent_space_id }}' -- required
AND region = '{{ region }}' -- required
AND userId = '{{ userId }}'
AND maxResults = '{{ maxResults }}'
AND nextToken = '{{ nextToken }}'
;

INSERT examples

create_chat

Creates a new chat execution in the specified agent space

INSERT INTO aws.devops_agent.chats (
agent_space_id,
region,
userId,
userType
)
SELECT 
'{{ agent_space_id }}',
'{{ region }}',
'{{ userId }}',
'{{ userType }}'
RETURNING
created_at,
execution_id
;

Manifest

# Description fields are for documentation purposes
- name: chats
props:
  - name: agent_space_id
    value: "{{ agent_space_id }}"
    description: Required parameter for the chats resource.
  - name: region
    value: "{{ region }}"
    description: Required parameter for the chats resource.
  - name: userId
    value: "{{ userId }}"
    description: The user identifier for the chat. This field is deprecated and will be ignored — the service resolves user identity from the authenticated session.
    description: The user identifier for the chat. This field is deprecated and will be ignored — the service resolves user identity from the authenticated session.
  - name: userType
    value: "{{ userType }}"
    description: The authentication type of the user
    description: The authentication type of the user