For Agents
Manage Hivelight matters, tasks, workflows, users, and webhooks for legal practice automation.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Hivelight API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Hivelight API.
Create, update, archive, and restore Hivelight matters with structured fields
Add notes to matters for audit trail and case-file context
List and retrieve tasks attached to matters or users
Look up users and their workspace memberships
GET STARTED
Use for: I want to create a new matter for a client engagement, Add a note to an existing matter for the case file, Archive a closed matter and move it out of active lists, List all open tasks across the firm's workspace
Not supported: Does not handle trust accounting, billing, or document generation — use for legal matter and task management only.
Hivelight is a legal practice management platform that organises matters (legal cases or files), tasks, users, workflows, and workspaces. The API exposes CRUD for matters with archive and notes operations, task lists, user lookup, webhooks for event-driven integration, and workflow and workspace endpoints. It is intended for law firms that need to programmatically read or update matter and task state across their practice management system.
Register webhooks to receive matter and task events in real time
Trigger and inspect workflows that automate matter transitions
Patterns agents use Hivelight API for, with concrete tasks.
★ Matter Intake Automation
Law firms triage new client intake into Hivelight matters using either an intake form or a CRM trigger. The API supports POST /api/matters with the structured client and engagement fields so a matter is created instantly and assigned to the right team. Time from intake submission to matter creation drops from manual hours to API seconds.
Create a Hivelight matter titled 'Smith v Acme' with client_id cli_999 and assignee user_lawyer_42.
Task and Deadline Tracking
Practice managers need a single view of upcoming task deadlines across all active matters. The agent calls GET /api/tasks with filters for status and due date, then surfaces overdue or near-due tasks to the responsible lawyer. This avoids missed deadlines that come from manually checking each matter.
List Hivelight tasks due within the next 7 days and group by assignee.
Webhook-Driven Case Updates
Document automation systems and client portals need real-time notification when matter state changes. Hivelight webhooks deliver matter and task events, letting agents update related systems immediately without polling. This keeps client-facing portals in sync with internal practice management.
Create a Hivelight webhook subscribed to matter status events for the firm's workspace pointing at the agent's ingestion URL.
Agent-Run Practice Workflow
An AI legal-ops agent connected via Jentic ingests new client emails, creates the matching Hivelight matter, adds an opening note, and assigns the responsible lawyer. The X-API-Key stays in the Jentic vault, so the agent never holds the raw credential. Setup takes under an hour because operation schemas load on demand.
From a new client email, create the Hivelight matter, add an opening note with the email summary, and assign user_lawyer_42.
20 endpoints — hivelight is a legal practice management platform that organises matters (legal cases or files), tasks, users, workflows, and workspaces.
METHOD
PATH
DESCRIPTION
/api/matters
Create a new matter
/api/matters/{matterid}
Fetch a specific matter
/api/matters/{matterid}/archive
Archive a matter
/api/matters/{matterid}/notes
Add a note to a matter
/api/tasks
List tasks
/api/matters
Create a new matter
/api/matters/{matterid}
Fetch a specific matter
/api/matters/{matterid}/archive
Archive a matter
/api/matters/{matterid}/notes
Add a note to a matter
/api/tasks
List tasks
Three things that make agents converge on Jentic-routed access.
Credential isolation
The X-API-Key header is stored encrypted in the Jentic vault. Agents execute Hivelight calls through Jentic and never see the raw key value.
Intent-based discovery
Agents search by intent (e.g., 'create a legal matter') and Jentic returns the matching Hivelight operation with its input schema, so the agent calls the right endpoint without reading docs.
Time to first call
Direct Hivelight integration: 1-2 days to wire auth, matter schemas, and webhook receipt. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Hivelight API through Jentic.
What authentication does the Hivelight API use?
Hivelight uses an API key sent in the X-API-Key header on every request. Through Jentic, the key is stored encrypted in the Jentic vault and added to the request at execution time, so the agent never reads the raw header.
Can I archive and restore matters with the Hivelight API?
Yes. POST /api/matters/{matterid}/archive moves a matter into archived state, and DELETE /api/matters/{matterid}/archive restores it back to active. This is useful for closing out completed engagements without permanently deleting case data.
What are the rate limits for the Hivelight API?
Hivelight does not publish hard rate limits in its OpenAPI spec. Keep request volume to a few per second per workspace and back off on 429 responses; for batch matter or task imports throttle to avoid impacting the firm's interactive usage.
How do I create a matter through Jentic?
Search Jentic for 'create hivelight matter', load POST /api/matters, and execute with the matter title, client id, and assignee fields. Run pip install jentic and use the async SearchRequest, LoadRequest, ExecutionRequest pattern.
Does Hivelight support webhooks for matter changes?
Yes. The webhooks resource lets you subscribe to matter and task events so external systems (client portals, document automation, billing) can react in real time instead of polling for changes.