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.

List active conversations for the current user.

get

Responses

200

Success

application/json

idstringOptional

Conversation unique identifier.

userIdstringOptional

ID of the user who owns this conversation.

tenantstringOptional

Tenant/workspace identifier to which this conversation belongs.

timestampstring · date-timeOptional

Timestamp when the conversation was created.

namestringOptional

Friendly name of the conversation.

400

Bad request

application/json

500

Internal Server Error

application/json

get

/api/v1/agent/conversations

HTTPcURLJavaScriptPython

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"
  }
]

Start a new conversation.

post

Responses

200

Success

application/json

idstringOptional

Conversation unique identifier.

userIdstringOptional

ID of the user who owns this conversation.

tenantstringOptional

Tenant/workspace identifier to which this conversation belongs.

timestampstring · date-timeOptional

Timestamp when the conversation was created.

namestringOptional

Friendly name of the conversation.

400

Bad request

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/conversations/start

HTTPcURLJavaScriptPython

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": ""
}

Update a conversation's details.

put

Path parameters

idstringRequired

Conversation ID

Body

application/json

idstringOptional

Conversation unique identifier.

userIdstringOptional

ID of the user who owns this conversation.

tenantstringOptional

Tenant/workspace identifier to which this conversation belongs.

timestampstring · date-timeOptional

Timestamp when the conversation was created.

namestringOptional

Friendly name of the conversation.

Responses

200

Success

application/json

idstringOptional

Conversation unique identifier.

userIdstringOptional

ID of the user who owns this conversation.

tenantstringOptional

Tenant/workspace identifier to which this conversation belongs.

timestampstring · date-timeOptional

Timestamp when the conversation was created.

namestringOptional

Friendly name of the conversation.

400

Bad request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

put

/api/v1/agent/conversations/{id}

HTTPcURLJavaScriptPython

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)"
}

Delete a conversation.

delete

Path parameters

idstringRequired

Conversation ID

Responses

200

Success (conversation deleted)

No content

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/api/v1/agent/conversations/{id}

HTTPcURLJavaScriptPython

DELETE /api/v1/agent/conversations/{id} HTTP/1.1
Host: api.peoplelogic.dev
Accept: */*

No content

Get agent task assignments (follow-up).

post

Retrieve the list of tasks assigned by the agent for the user's last question. Requires an existing conversation (conversationId must be provided).

Body

application/json

questionstringOptional

User's question or message.

maxResultsintegerOptional

Max number of results or steps (defaults to 5).

additionalInstructionsstringOptional

Additional instructions or context for the agent.

conversationIdstringOptional

ID of an existing conversation (for follow-ups; omit for new questions).

sincestring · date-timeOptional

If provided, get history messages since this timestamp (used in history request).

Responses

200

Success

application/json

responsestringOptional

Agent's response summary or prompt to the user (e.g., asking for confirmation).

needsConfirmationbooleanOptional

True if the agent is awaiting user confirmation or input to proceed.

newWorkflowbooleanOptional

True if the agent is proposing a new scheduled workflow.

scheduleFrequencystring · enumOptional

Frequency for scheduled workflow execution.

Possible values:

hourOfWorkflowintegerOptional

Hour of day (0-23) for scheduled workflow execution (if applicable).

dayOfWorkflowintegerOptional

Day of week or month for scheduled workflow (if applicable).

minuteOfWorkflowintegerOptional

Minute of hour for scheduled workflow (if applicable).

timeZonestringOptional

Time zone identifier for the scheduled workflow (if applicable).

subscriptionActivebooleanOptional

Indicates if the user's subscription is active (true) or if execution is limited due to subscription issues.

notificationChannelstring · enumOptional

Channel for completion notification.

Possible values:

notificationTostringOptional

Target identifier for completion notification (e.g., email address or Slack channel, if provided).

userIdstringOptional

Identifier of the user for whom the tasks are assigned.

400

Bad request

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/assign

HTTPcURLJavaScriptPython

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"
}

Ask a question (start a new conversation).

post

Submit a question to the Peoplelogic agent. Do not include a conversationId (a new conversation will be started).

Body

application/json

questionstringOptional

User's question or message.

maxResultsintegerOptional

Max number of results or steps (defaults to 5).

additionalInstructionsstringOptional

Additional instructions or context for the agent.

conversationIdstringOptional

ID of an existing conversation (for follow-ups; omit for new questions).

sincestring · date-timeOptional

If provided, get history messages since this timestamp (used in history request).

Responses

200

Success

application/json

successbooleanRequired

Whether the request succeeded.

replystringRequired

The agent's response message.

confirmingbooleanOptional

True if the agent is asking for confirmation from the user.

conversationstringOptional

Conversation ID this response is associated with (if any).

400

Bad request

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/ask

HTTPcURLJavaScriptPython

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 reply in a conversation.

post

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.

Body

application/json

questionstringOptional

User's question or message.

maxResultsintegerOptional

Max number of results or steps (defaults to 5).

additionalInstructionsstringOptional

Additional instructions or context for the agent.

conversationIdstringOptional

ID of an existing conversation (for follow-ups; omit for new questions).

sincestring · date-timeOptional

If provided, get history messages since this timestamp (used in history request).

Responses

200

Success

application/json

successbooleanRequired

Whether the request succeeded.

replystringRequired

The agent's response message.

confirmingbooleanOptional

True if the agent is asking for confirmation from the user.

conversationstringOptional

Conversation ID this response is associated with (if any).

400

Bad request

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/reply

HTTPcURLJavaScriptPython

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
}

Upload a file to the knowledge base (Admin only).

post

Body

multipart/form-data

filestring · binaryOptional

Responses

200

Success

application/json

successbooleanRequired

Whether the request succeeded.

replystringRequired

The agent's response message.

confirmingbooleanOptional

True if the agent is asking for confirmation from the user.

conversationstringOptional

Conversation ID this response is associated with (if any).

404

Not Found

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/add-file-knowledge

HTTPcURLJavaScriptPython

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
}

Add a URL to the knowledge base (Admin only).

post

Body

text/plain

string · uriOptional

Responses

200

Success

application/json

successbooleanRequired

Whether the request succeeded.

replystringRequired

The agent's response message.

confirmingbooleanOptional

True if the agent is asking for confirmation from the user.

conversationstringOptional

Conversation ID this response is associated with (if any).

404

Not Found

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/add-url-knowledge

HTTPcURLJavaScriptPython

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
}