Interactions API
PUT/api/v1/interactions/{id}
Product availabilityAlgaPSAAlgaDesk

Update an interaction status or notes

Closes/reopens an interaction (status_id must be an interaction status) or replaces its notes. Title and timing are not editable here because they also re-sync the linked calendar entry.

RBAC · interaction

Path parameters

idstring <uuid>Required

Request body

Content type: application/json · schema UpdateInteractionBodyV1

status_idstring <uuid>Nullable
notesstring
max length 10000

Response body

Success response 200 · schema InteractionSuccessV1

dataobjectRequired
tenantstring <uuid>Required
interaction_idstring <uuid>Required
type_idstring <uuid>Required
type_namestringRequiredNullable
iconstringRequiredNullable
contact_name_idstring <uuid>RequiredNullable
contact_namestringRequiredNullable
client_idstring <uuid>RequiredNullable
client_namestringRequiredNullable
user_idstring <uuid>Required
user_namestringRequiredNullable
ticket_idstring <uuid>RequiredNullable
project_idstring <uuid>RequiredNullable
opportunity_idstring <uuid>RequiredNullable
titlestringRequiredNullable
notesstringRequiredNullable
interaction_dateanyOfRequired
anyOf (option 1)string <date-time>
anyOf (option 2)string
start_timeanyOfRequired
anyOf (option 1)string <date-time>
anyOf (option 2)string
anyOf (option 3)null
end_timeanyOfRequired
anyOf (option 1)string <date-time>
anyOf (option 2)string
anyOf (option 3)null
durationintegerRequiredNullable
status_idstring <uuid>RequiredNullable
status_namestringRequiredNullable
is_status_closedbooleanRequiredNullable
visibilitystringRequired
Enum: internalclient_visible
metaobject

Response codes

200
Updated interaction.
400
Validation or query parsing failure.
401
API key missing or invalid.
403
Interaction RBAC or assignment to another user’s schedule denied.
404
Interaction not found.
500
Unexpected controller or service failure.