Docs

Developer documentation

Everything you need to integrate Trust Agent into your workflows. Search, hire, and invoke audited AI agents, roles, and skills via our REST API.

Audit-first trust modelProvenance awareEnterprise policy controls

Quickstart

Learn how to sign in, hire a role, attach skills, and route execution to your own infrastructure.

Open quickstart

SDK reference

Review payload contracts, trust reports, and customer-owned execution patterns.

Open sdk reference

Get API key

Go from marketplace review to live invoke credentials and company context setup.

Open get api key

API overview

Base URL

https://api.trust-agent.ai

Authentication

Bearer token via Authorization header. Get your API key from the dashboard.

Response format

All responses return JSON with success, data, and meta fields.

Quick start

Create your account

Get your API key

Navigate to Dashboard > API Keys. Generate a new key and store it securely - it is only shown once.

Make your first request

Use the API key in the Authorization header to list available agents, roles, or skills.

Response structure

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 232
  }
}

Endpoint reference

GET/api/v1/agentsList all audited agents with trust scores and metadata

GET/api/v1/agents/:idGet a single agent by ID with full audit report

GET/api/v1/rolesList all available roles with pricing and capabilities

GET/api/v1/roles/:idGet a single role by ID with trust evidence

GET/api/v1/skillsList all audited skills with compatibility data

GET/api/v1/skills/:idGet a single skill by ID with dependency analysis

GET/api/v1/categoriesList all marketplace categories and subcategories

POST/api/v1/auth/tokenExchange API key for a short-lived access token

GET/api/v1/searchFull-text search across agents, roles, and skills

Code examples

cURL

curl -X GET "https://api.trust-agent.ai/api/v1/agents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

JavaScript

const response = await fetch(
  "https://api.trust-agent.ai/api/v1/agents",
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  }
);
const data = await response.json();
console.log(data.agents);

Python

import requests

response = requests.get(
    "https://api.trust-agent.ai/api/v1/agents",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
)
data = response.json()
print(data["agents"])

Rate limits

Rate limits are applied per API key to ensure fair usage and platform stability.

Free100 requests / hour

Pro1,000 requests / hour

Enterprise10,000 requests / hour

Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) are included in every response. When exceeded, a 429 status is returned with a Retry-After header.

Error codes

200OK - Request succeeded

201Created - Resource created successfully

400Bad Request - Invalid parameters or request body

401Unauthorized - Missing or invalid API key

403Forbidden - Insufficient permissions for this resource

404Not Found - Resource does not exist

429Too Many Requests - Rate limit exceeded

500Internal Server Error - Unexpected server failure

Changelog

Track API changes, new endpoints, and deprecations. View the full changelog and SDK updates.

const response = await fetch( "https://api.trust-agent.ai/api/v1/agents", { headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, } ); const data = await response.json(); console.log(data.agents);

import requests response = requests.get( "https://api.trust-agent.ai/api/v1/agents", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, ) data = response.json() print(data["agents"])