> ## Documentation Index
> Fetch the complete documentation index at: https://help.kenekt.app/llms.txt
> Use this file to discover all available pages before exploring further.

# An agent's activity timeline

> The agent's activity, newest first, a page at a time.



## OpenAPI

````yaml /api-reference/management-openapi.yaml get /{agency_uid}/insights/engagements/{id}/timeline
openapi: 3.0.3
info:
  title: Kenekt Management API
  version: v1
  description: >-
    Manage an agency's stock and team: projects, lots, packages, designs,
    facades, developments, inclusions, commission rates, members and groups.


    Authenticate with an API key from a staff or admin member's account page,
    sent as `Authorization: Bearer YOUR_API_KEY`. A key works on every agency
    where its holder has a staff role; put that agency's public id in the path.


    This API is evolving: endpoints and fields may change without notice.
servers:
  - url: https://app.kenekt.com.au/v1
security: []
tags:
  - name: Stock / Projects
    description: 'Projects: a stage or release inside a development, grouping the lots.'
  - name: Stock / Lots
    description: Lots, their status, and moves between projects.
  - name: Stock / Packages
    description: 'Property packages: the sellable pairing of a lot with a design and facade.'
  - name: Stock / Designs
    description: Designs, their price tiers, rooms, and linked facades.
  - name: Stock / Facades
    description: Facades offered against designs.
  - name: Stock / Developments
    description: 'Developments: the estate or masterplanned community projects sit inside.'
  - name: Stock / Inclusions
    description: Inclusion packages, their items, and what they are linked to.
  - name: Stock / Commission Rates
    description: Commission rates and what they are applied to.
  - name: Stock / Attachments
    description: Photos and documents on any stock resource.
  - name: Stock / Library
    description: >-
      The whole library (designs, price tiers, facades, inclusions) as flat
      export rows.
  - name: Team / Members
    description: Members of the agency, their API keys, documents, and inclusions.
  - name: Team / Groups
    description: User groups and their memberships.
  - name: Team / Engagement
    description: >-
      Agent engagement: who is active, who has gone quiet, what they view and
      search for.
  - name: Agency
    description: The agency record and its settings.
  - name: Agency / Documents
    description: Agency-level documents.
  - name: EOIs
    description: Expressions of interest, purchasers, and sighted ID capture.
paths:
  /{agency_uid}/insights/engagements/{id}/timeline:
    get:
      tags:
        - Team / Engagement
      summary: An agent's activity timeline
      description: The agent's activity, newest first, a page at a time.
      parameters:
        - name: agency_uid
          in: path
          required: true
          schema:
            type: string
          description: Agency public_uid
        - name: days
          in: query
          required: false
          schema:
            type: integer
          example: 30
        - name: id
          in: path
          required: true
          schema:
            type: string
          example: USR-USER1-001
        - name: page
          in: query
          required: false
          schema:
            type: integer
          example: 1
      responses:
        '200':
          description: OK
          headers:
            Content-Type:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  agent:
                    type: object
                    properties:
                      public_uid:
                        type: string
                      name:
                        type: string
                      email:
                        type: string
                    required:
                      - public_uid
                      - name
                      - email
                  rows:
                    type: array
                    items:
                      type: object
                      properties:
                        at:
                          type: string
                        kind:
                          type: string
                        summary:
                          type: string
                        package_public_uid:
                          type: string
                          nullable: true
                        deal_id:
                          nullable: true
                        via:
                          type: string
                          nullable: true
                      required:
                        - at
                        - kind
                        - summary
                        - package_public_uid
                        - deal_id
                        - via
                  total_count:
                    type: integer
                  page:
                    type: integer
                  has_more:
                    type: boolean
                  truncated_sources:
                    type: array
                    items: {}
                  stream_ends_at:
                    nullable: true
                  sign_in_tracking_since:
                    type: string
                    nullable: true
                  mcp_calls_retained_days:
                    type: integer
                  period:
                    type: object
                    properties:
                      days:
                        type: integer
                      from:
                        type: string
                      to:
                        type: string
                    required:
                      - days
                      - from
                      - to
                required:
                  - agent
                  - rows
                  - total_count
                  - page
                  - has_more
                  - truncated_sources
                  - stream_ends_at
                  - sign_in_tracking_since
                  - mcp_calls_retained_days
                  - period
              example:
                agent:
                  public_uid: USR-USER1-001
                  name: User One
                  email: user1@example.com
                rows:
                  - at: '2026-09-20T09:31:22+10:00'
                    kind: package_view
                    summary: 123 Test St NORTH ROCKS NSW 2151
                    package_public_uid: BP-1234
                    deal_id: null
                    via: null
                  - at: '2026-09-20T07:31:22+10:00'
                    kind: sign_in
                    summary: Signed in (magic link)
                    package_public_uid: null
                    deal_id: null
                    via: magic_link
                total_count: 2
                page: 1
                has_more: false
                truncated_sources: []
                stream_ends_at: null
                sign_in_tracking_since: '2026-09-20T07:31:22+10:00'
                mcp_calls_retained_days: 30
                period:
                  days: 30
                  from: '2026-08-21T09:31:22+10:00'
                  to: '2026-09-20T09:31:22+10:00'
      security:
        - bearer_auth: []
components:
  securitySchemes:
    bearer_auth:
      type: http
      scheme: bearer
      bearerFormat: Token

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.