Conversations
The Directory API gives you access to Organizations, Accounts, Employees and Groups. Every Entity within the subsequent API calls must have an Organization attached and API calls must be made with a User specific JWT.
GET /api/v1/agent/conversations HTTP/1.1
Host: api.peoplelogic.dev
Accept: */*
[
{
"id": "c123e4567-e89b-12d3-a456-426614174001",
"userId": "user123",
"tenant": "tenantXYZ",
"timestamp": "2025-07-13T15:00:00Z",
"name": "Project Kickoff Discussion"
}
]POST /api/v1/agent/conversations/start HTTP/1.1
Host: api.peoplelogic.dev
Accept: */*
{
"id": "d123e4567-e89b-12d3-a456-426614174002",
"userId": "user123",
"tenant": "tenantXYZ",
"timestamp": "2025-07-13T15:05:00Z",
"name": ""
}Conversation ID
Conversation unique identifier.
ID of the user who owns this conversation.
Tenant/workspace identifier to which this conversation belongs.
Timestamp when the conversation was created.
Friendly name of the conversation.
PUT /api/v1/agent/conversations/{id} HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 167
{
"id": "c123e4567-e89b-12d3-a456-426614174001",
"userId": "user123",
"tenant": "tenantXYZ",
"timestamp": "2025-07-13T15:00:00Z",
"name": "Project Kickoff Discussion (Updated)"
}{
"id": "c123e4567-e89b-12d3-a456-426614174001",
"userId": "user123",
"tenant": "tenantXYZ",
"timestamp": "2025-07-13T15:00:00Z",
"name": "Project Kickoff Discussion (Updated)"
}Conversation ID
DELETE /api/v1/agent/conversations/{id} HTTP/1.1
Host: api.peoplelogic.dev
Accept: */*
No content
Retrieve the list of tasks assigned by the agent for the user's last question. Requires an existing conversation (conversationId must be provided).
User's question or message.
Max number of results or steps (defaults to 5).
Additional instructions or context for the agent.
ID of an existing conversation (for follow-ups; omit for new questions).
If provided, get history messages since this timestamp (used in history request).
POST /api/v1/agent/assign HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 78
{
"question": "How can I improve team productivity?",
"conversationId": "conv123"
}{
"response": "I will compile the sales data and draft an email. Would you like me to proceed?",
"needsConfirmation": true,
"newWorkflow": false,
"agents": [
{
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent."
},
"specificTask": "Compile Q1 and Q2 sales data",
"step": 0,
"dependsOn": -1,
"workflowAssignment": false
},
{
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent."
},
"specificTask": "Draft an email summarizing the sales data",
"step": 1,
"dependsOn": 0,
"workflowAssignment": false
}
],
"subscriptionActive": true,
"userId": "tenantXYZ_user123"
}Submit a question to the Peoplelogic agent. Do not include a conversationId (a new conversation will be started).
User's question or message.
Max number of results or steps (defaults to 5).
Additional instructions or context for the agent.
ID of an existing conversation (for follow-ups; omit for new questions).
If provided, get history messages since this timestamp (used in history request).
POST /api/v1/agent/ask HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 51
{
"question": "How can I improve team productivity?"
}{
"success": true,
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent.",
"coordinator": true
},
"reply": "Encourage open communication and regular feedback...",
"sources": [
{
"name": "Employee Handbook",
"type": "document",
"url": "https://example.com/handbook.pdf"
}
],
"confirming": false
}Send a follow-up message or confirmation in an existing conversation. This is typically used to confirm task execution or ask a clarifying question, using the conversationId from a previous response.
User's question or message.
Max number of results or steps (defaults to 5).
Additional instructions or context for the agent.
ID of an existing conversation (for follow-ups; omit for new questions).
If provided, get history messages since this timestamp (used in history request).
POST /api/v1/agent/reply HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 62
{
"question": "Yes, please proceed.",
"conversationId": "conv123"
}{
"success": true,
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent.",
"coordinator": true
},
"reply": "Sure, I've sent the summary email to the team.",
"confirming": false
}POST /api/v1/agent/add-file-knowledge HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17
{
"file": "binary"
}{
"success": true,
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent.",
"coordinator": true
},
"reply": "Added handbook.pdf to the knowledge base for your organization!",
"confirming": false
}POST /api/v1/agent/add-url-knowledge HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: text/plain
Accept: */*
Content-Length: 30
"https://docs.example.com/FAQ"{
"success": true,
"agent": {
"name": "Peoplelogic Agent",
"persona": "A general purpose AI agent.",
"coordinator": true
},
"reply": "Added https://docs.example.com/FAQ to the knowledge base for your organization!",
"confirming": false
}Was this helpful?