Activities

List activities

Retrieves a paginated, filterable list of activity log entries. Standard users see only their own activities. Admin users see all activities and can filter by user.

string

required

activities

string

required

all

object

Show properties

number

Maximum number of records to return. Defaults to 50.

number

Number of records to skip for pagination. Defaults to 0.

boolean

Admin only. When true, returns activities for all users.

string

Admin only. Filter activities to a specific user.

object

Optional filter criteria.

Show properties

string

Filter by activity category.

string

Filter by activity type.

string

Filter by action performed.

string[]

Array of action values to exclude from results (e.g. ["viewed"]).

string

ISO 8601 timestamp. Return activities created on or after this date.

string

ISO 8601 timestamp. Return activities created on or before this date.

string

Filter by the type of resource the activity relates to.

string

Filter by the ID of the resource the activity relates to.

string

Search term. Matches against the activity title, description, and resource name.

Common enum values

The following tables list the most commonly used values for the filter and data fields. These are not exhaustive — custom values may appear as new features are added. activity_type values

Value	Description
`genie`	Actions related to genie (agent) management
`document`	Knowledge base document operations
`user`	User account and profile changes
`team`	Team membership and settings changes
`conversation`	Conversation lifecycle events
`system`	System-generated events (billing, maintenance, etc.)

action values

Value	Description
`created`	A resource was created
`updated`	A resource was modified
`deleted`	A resource was removed
`viewed`	A resource was accessed or opened
`exported`	Data was exported
`imported`	Data was imported

category values

Value	Description
`agent_management`	Genie creation, configuration, and deployment
`knowledge_management`	Document uploads, processing, and organization
`user_management`	User invitations, role changes, and profile updates
`team_management`	Team creation, member additions, and settings
`conversation`	Conversation syncing, analysis, and review

const response = await ApiService.invoke({
  resource: "activities",
  action: "all",
  data: {
    limit: 20,
    offset: 0,
    filters: {
      category: "agent_management",
      activityType: "genie",
      action: "created",
      startDate: "2025-01-01T00:00:00Z",
      endDate: "2025-12-31T23:59:59Z",
      searchTerm: "created",
    },
  },
});

curl -X POST https://api.helpgenie.ai/v1/activities \
  -H "Authorization: Bearer hg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resource": "activities",
    "action": "all",
    "data": {
      "limit": 20,
      "offset": 0,
      "filters": {
        "category": "agent_management",
        "activityType": "genie",
        "action": "created",
        "startDate": "2025-01-01T00:00:00Z",
        "endDate": "2025-12-31T23:59:59Z"
      }
    }
  }'

Response

Activity[]

Array of activity records.

Show Activity object

string

Unique activity identifier.

string

The type of activity (e.g., genie, document, system).

string

The action performed (e.g., created, updated, deleted).

string

Human-readable title describing the activity.

string | null

Activity category for grouping.

string | null

Detailed description of the activity.

string | null

Activity status.

string | null

Activity priority level.

string | null

The type of resource this activity relates to.

string | null

The ID of the related resource.

string | null

The name of the related resource.

number | null

Duration of the activity in milliseconds, if applicable.

object | null

Arbitrary metadata associated with the activity.

string | null

Session identifier for grouping related activities.

string | null

ID of the user who performed the activity.

boolean | null

Whether the activity is visible in the UI.

string

ISO 8601 timestamp of when the activity was created.

number

Total number of matching activities.

number

The limit that was applied.

number

The offset that was applied.

Get activity

Retrieves a single activity record by ID. Standard users can only access their own activities.

string

required

activities

string

required

get

string

required

The activity ID.

const response = await ApiService.invoke({
  resource: "activities",
  action: "get",
  id: "activity-uuid",
});

Response

Activity

The requested activity object. See Activity object for field details.

Create activity

Creates a new activity record. Restricted to admin users and service-role callers.

string

required

activities

string

required

create

object

required

Show properties

string

required

The type of activity.

string

required

The action that was performed.

string

required

Human-readable title for the activity.

string

Activity category.

string

Detailed description.

string

Activity status.

string

Priority level.

string

Type of the related resource.

string

ID of the related resource.

string

Name of the related resource.

number

Duration in milliseconds.

object

Arbitrary metadata.

string

Session identifier for grouping.

string

User ID to attribute the activity to. Defaults to the authenticated user.

boolean

Whether the activity should be visible in the UI.

Only admin users (internal_* role) and service-role callers can create activities. Standard users receive a 403 FORBIDDEN error.

const response = await ApiService.invoke({
  resource: "activities",
  action: "create",
  data: {
    activity_type: "genie",
    action: "created",
    title: "New genie created: Sales Assistant",
    resource_type: "agent",
    resource_id: "agent-uuid",
    resource_name: "Sales Assistant",
    metadata: {
      voice_id: "voice-id",
    },
  },
});

Response (status 201)

Activity

The newly created activity object.

Weekly summary

Returns 7-day outcome tiles: conversations handled, after-hours coverage, attention count (escalations + low sentiment + negative feedback), and silent genie count. Includes prior-week deltas.

string

required

activities

string

required

weekly-summary

object

Show properties

boolean

Admin only. Aggregate across all users.

string

Admin only. Scope to a specific user.

object

Current and previous week conversation counts with percentage delta.

object

Count of conversations that occurred outside business hours.

object

Aggregated attention count (escalations + low sentiment + negative feedback).

object

Count of genies with no recent conversations.

const response = await ApiService.invoke({
  resource: "activities",
  action: "weekly-summary",
});

curl -X POST https://api.helpgenie.ai/v1/activities \
  -H "Authorization: Bearer hg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource": "activities", "action": "weekly-summary"}'

Needs attention

Returns the prioritised list of issues from the last 7 days: escalated conversations, low-sentiment conversations, negative feedback, and silent genies. Up to 10 items per bucket.

string

required

activities

string

required

needs-attention

object

Show properties

boolean

Admin only. Return attention items across all users.

string

Admin only. Scope to a specific user.

object[]

Conversations with human escalation requests.

object[]

Conversations with a sentiment score below 0.4.

object[]

Conversations with negative caller feedback.

object[]

Genies with no conversations in the last 7 days.

const response = await ApiService.invoke({
  resource: "activities",
  action: "needs-attention",
});

curl -X POST https://api.helpgenie.ai/v1/activities \
  -H "Authorization: Bearer hg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"resource": "activities", "action": "needs-attention"}'

Conversation digest

Synthesises a genie-voiced story across the user’s analysed conversations for a given period, plus decision-shaped highlights (wins, opportunities, recurring themes, things to revisit). Returns hasEnoughData: false when there isn’t enough analysed material.

Backed by a language model call. Cache on the client — the dashboard caches for 30 minutes.

string

required

activities

string

required

conversation-digest

object

Show properties

string

default:"30d"

Time window for the digest. One of "7d", "30d", "90d", or "all".

string

Scope the digest to a single genie.

boolean

Admin only. Generate digest across all users.

string

Admin only. Impersonate a specific user.

boolean

false when there is insufficient analysed conversation material to generate a meaningful digest.

string

Genie-voiced narrative summarising the period.

object

Decision-shaped highlights — wins, opportunities, recurring themes, and things to revisit.

const response = await ApiService.invoke({
  resource: "activities",
  action: "conversation-digest",
  data: {
    dateRange: "30d",
    agentId: "agent-uuid",
  },
});

curl -X POST https://api.helpgenie.ai/v1/activities \
  -H "Authorization: Bearer hg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resource": "activities",
    "action": "conversation-digest",
    "data": {
      "dateRange": "30d"
    }
  }'

Forbidden actions

The update and delete actions are not permitted on activities. All callers — including admin users — receive a 403 FORBIDDEN error.

// Returns 403 FORBIDDEN
const response = await ApiService.invoke({
  resource: "activities",
  action: "update",
  id: "activity-uuid",
  data: { title: "Updated title" },
});

// Returns 403 FORBIDDEN
const response = await ApiService.invoke({
  resource: "activities",
  action: "delete",
  id: "activity-uuid",
});

Activity records are immutable once created. The update and delete actions return 403 FORBIDDEN for all callers, including admin users and service-role tokens. This is by design — audit logs must remain tamper-proof. If you need to correct an activity, create a new compensating entry instead.

Overview

Public (unauthenticated)

Agents

Knowledge

CRM

Marketplace

Platform

Telephony

Worker genies

Quality & Compliance

Access Control

Intelligence

Education

Voice

Integrations

Expanded Platform

List activities

Common enum values

Response

Get activity

Response

Create activity

Response (status 201)

Weekly summary

Needs attention

Conversation digest

Forbidden actions

​List activities

​Common enum values

​Response

​Get activity

​Response

​Create activity

​Response (status 201)

​Weekly summary

​Needs attention

​Conversation digest

​Forbidden actions

List activities

Common enum values

Response

Get activity

Response

Create activity

Response (status 201)

Weekly summary

Needs attention

Conversation digest

Forbidden actions