Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt

Use this file to discover all available pages before exploring further.

​
List Agents

GET /v1/agents Returns a paginated list of all machine agent identities registered under the authenticated tenant. Results can be filtered by agent type, status, and trust level. Agents are returned in reverse chronological order (newest first).

​
Authentication

Requires X-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.

​
Query Parameters

​
agent_type
string
Filter by agent type. One of: "orchestrator", "worker", "inference", "pipeline", "service", "bot", "llm".
​
status
string
Filter by lifecycle status. One of: "active", "suspended", "revoked".
​
trust_level
string
Filter by trust level. One of: "platform_root", "verified_org", "verified_individual", "authenticated", "self_asserted", "anonymous".
​
limit
integer
Maximum number of agents to return per page. Range: 1-200. Default: 50.
​
offset
integer
Number of records to skip for pagination. Default: 0.

​
Response

​
agents
object[]
Array of agent identity objects. Each object contains the full agent record including agent_id, agent_type, display_name, status, trust_level, trust_score, scopes, public_key, key_id, metadata, delegation_depth, created_at, and updated_at.
​
total
integer
Total count of agents matching the filter criteria, across all pages.

​
Example

curl -G https://api.truthlocks.com/v1/agents \
  -H "X-API-Key: tl_live_..." \
  -d "status=active" \
  -d "agent_type=llm" \
  -d "limit=10" \
  -d "offset=0"