Function updateConversationAttributes

updateConversationAttributes<ThrowOnError extends boolean = true>(
    options: Options<UpdateConversationAttributesData, ThrowOnError>,
): RequestResult<
    {
        data: {
            attributes: {
                assignedTeams: unknown[];
                assignedUsers: unknown[];
                channels: unknown[];
                createdAt: string;
                direction: string;
                externalQueue: string;
                firstResponse: { [key: string]: unknown };
                lastMessageIn: { [key: string]: unknown };
                messageCount: number;
                modifiedAt: string;
                name: string;
                noteCount: number;
                outboundMessageCount: number;
                rev: number;
                satisfaction: number;
                sentiment: { [key: string]: unknown };
                status: string;
                suggestedTags: unknown[];
                tags: unknown[];
                updatedAt: string;
            };
            id: string;
            links: { self: string };
            relationships: {
                createdBy: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                customer: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                messages: { links: { self: string } };
                modifiedBy: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                org: { data: { id: string; type: string }; links: { self: string } };
            };
            type: string;
        };
    },
    unknown,
    ThrowOnError,
>
Update conversation attributes Updates the data attributes of a conversation based the unique conversation ID.

Any one of the following roles is required for this endpoint:

Legacy Role Equivalent Permission Set Role

org.user.conversation.write org.permission.conversation.update

Note

This endpoint is subject to Object Rate Limiting, which limits how many updates a single user can make to a single company attribute. To learn more, see Rate limiting.

Custom Attributes
Custom attributes are optional and allow you to specify custom key-value pairs.

Kustomer uses a naming convention for custom attributes to specify the field data type with a name suffix:

Naming Suffix
- Num number or null
- At date-time or null
- Str string or null, length: [ 0 .. 1024 ] characters
- Txt string or null, length: [ 0 .. 1024 ] characters
- Bool boolean or null
- Url string or null, format: uri
Type Parameters
- ThrowOnError extends boolean = true
Parameters
- options: Options<UpdateConversationAttributesData, ThrowOnError>
Returns RequestResult<
    {
        data: {
            attributes: {
                assignedTeams: unknown[];
                assignedUsers: unknown[];
                channels: unknown[];
                createdAt: string;
                direction: string;
                externalQueue: string;
                firstResponse: { [key: string]: unknown };
                lastMessageIn: { [key: string]: unknown };
                messageCount: number;
                modifiedAt: string;
                name: string;
                noteCount: number;
                outboundMessageCount: number;
                rev: number;
                satisfaction: number;
                sentiment: { [key: string]: unknown };
                status: string;
                suggestedTags: unknown[];
                tags: unknown[];
                updatedAt: string;
            };
            id: string;
            links: { self: string };
            relationships: {
                createdBy: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                customer: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                messages: { links: { self: string } };
                modifiedBy: {
                    data: { id: string; type: string };
                    links: { self: string };
                };
                org: { data: { id: string; type: string }; links: { self: string } };
            };
            type: string;
        };
    },
    unknown,
    ThrowOnError,
>
- Defined in src/api/sdk.gen.ts:1079

Function updateConversationAttributes

Note

Custom Attributes

Naming Suffix

Type Parameters

Parameters

Settings

On This Page