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

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

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