Create Session

Create a new session within a conversation. Provide a session ID, owner information, and at least one initial participant.

URI: /api/v1/agentic/conversations/{conversationId}/sessions

Format: application/json

HTTP Method: POST

Authentication: Bearer JWT

ParameterRequiredDescription
conversationIdYesConversation identifier.
HeaderRequiredDescription
AuthorizationYesBearer JWT token.
agent_idYesRegistered agent API name.
FieldTypeRequiredDescription
sessionIdStringYesCaller-supplied unique identifier for this session.
conversationOwnerIdStringYesIndividual or User ID. Must align with parent conversation.
ownerTypeStringYesType of owner. Values: individual, employee.
participantsArrayYesInitial participant set. Minimum 1 participant required.
participants[].idStringYesParticipant identifier.
participants[].typeStringYesParticipant type. Values: individual, employee, agent, or free-form string.
participants[].roleStringYesParticipant role. Values: owner, participant.
participants[].startTimeString (ISO 8601)NoJoin time.
participants[].endTimeString (ISO 8601)NoLeave time. Null indicates active participation.
participants[].orgIdStringNoOrganization ID for cross-org handoffs.
variableMapNoArbitrary metadata.
FieldTypeDescription
statusCodeStringOperation status. Value: created.
conversationIdStringParent conversation identifier.
sessionIdStringThe created session identifier.

Status: 201 Created

Status CodeDescription
400Bad Request. Invalid request format or missing required fields.
401Unauthorized. Invalid or missing JWT token.
404Not Found. Conversation does not exist.
500Internal Server Error.