History

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.

Search conversation history.

post

Body

application/json

querystringRequired

Search query string.

pageintegerOptional

Page number (0-based) for paginated results.

countintegerOptional

Number of results per page.

Responses

200

Success

application/json

idstringOptional

Identifier of the search result (message or conversation ID).

conversationIdstringOptional

ID of the conversation associated with this result.

resultstringOptional

Text snippet or summary of the result.

timestampstring · date-timeOptional

Timestamp of the message or conversation.

typestringOptional

Result type (e.g., "conversation" or "message").

400

Bad request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/search

HTTPcURLJavaScriptPython

POST /api/v1/agent/search HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "query": "sales report",
  "page": 0,
  "count": 10
}

[
  {
    "id": "conv123",
    "conversationId": "conv123",
    "result": "Conversation about Quarterly Results",
    "timestamp": "2025-07-01T08:00:00Z",
    "type": "conversation"
  },
  {
    "id": "msg789",
    "conversationId": "conv123",
    "result": "Q2 sales increased by 20%.",
    "timestamp": "2025-07-01T08:05:00Z",
    "type": "message"
  }
]

Retrieve conversation history.

post

Get all messages in a conversation, optionally those after a specific time.

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

tenantstringOptional

Tenant/workspace of the user.

userIdstringOptional

User ID who initiated or is associated with the message.

agentstringOptional

Name of the agent that produced the response (empty for user messages).

messageTypestringOptional

Type of message (e.g., "user_request" or "agent_response").

messagestringOptional

Message content.

tokenUsageintegerOptional

Number of language model tokens used for this message (if applicable).

timeSpentintegerOptional

Time spent (in milliseconds) processing this message.

conversationIdstringOptional

ID of the conversation this message belongs to.

timestampstring · date-timeOptional

Timestamp of the message.

400

Bad request

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

post

/api/v1/agent/history

HTTPcURLJavaScriptPython

POST /api/v1/agent/history HTTP/1.1
Host: api.peoplelogic.dev
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "conversationId": "conv123",
  "since": "2025-07-13T00:00:00Z"
}

[
  {
    "tenant": "acme-inc",
    "userId": "user123",
    "agent": "",
    "messageType": "user_request",
    "message": "How can I improve team productivity?",
    "tokenUsage": 0,
    "timeSpent": 0,
    "conversationId": "conv123",
    "timestamp": "2025-07-13T15:00:00Z",
    "sources": []
  },
  {
    "tenant": "acme-inc",
    "userId": "user123",
    "agent": "Peoplelogic Agent",
    "messageType": "agent_response",
    "message": "Encourage open communication and regular feedback...",
    "tokenUsage": 1500,
    "timeSpent": 3000,
    "conversationId": "conv123",
    "timestamp": "2025-07-13T15:00:05Z",
    "sources": [
      {
        "name": "Employee Handbook",
        "type": "document",
        "url": "https://example.com/handbook.pdf"
      }
    ]
  }
]