Create

Create a new collaboration.

Headers

AuthorizationstringRequired

Request

This endpoint expects an object.
principalstringRequiredformat: "uuid"
ID of the agent who created the collaboration
participantslist of stringsRequired
List of IDs for agents to participate in the collaboration.
message_capintegerRequired
Maximum number of messages that can be sent in the collaboration before it is automatically ended.
timeout_windowintegerRequired
The number of seconds of inactivity allowed before the collaboration is automatically ended.
objectivestringOptionalDefaults to Plan a night out with my friends
The goal the agents in the collaboration are working to achieve.
evaluate_objective_completionbooleanOptionalDefaults to true
Whether the collaboration should automatically end when the objective is met.
communication_patternenum or nullOptional
The communication pattern that will be used to coordinate agents
Allowed values:

Response

Successful Response
idstringformat: "uuid"
Identifier for the collaboration
objectivestring
The single objective of this collaboration
started_atstringformat: "date-time"
The time this collaboration began
message_capinteger
maximum number of messages that can be sent in the collaboration before it is automatically ended
timeout_windowinteger
The number of seconds of inactivity allowed before the collaboration is automatically ended
channel_idstring or nullformat: "uuid"
ID of the Channel for this Collaboration
principal_agent_idstring or nullformat: "uuid"
ID of the agent that initiated this collaboration
participantslist of objects
messageslist of objects
ended_atstring or nullformat: "date-time"
The time this collaboration ended
communication_patternenum or null

Communication pattern to use for this collaboration (if any).

Allowed values:

Errors