Skip to main content

​
API Overview

The Treeship API is a REST API for creating and verifying cryptographic attestations.

​
Base URL

https://api.treeship.dev

​
Authentication

Get an API key via email verification, then include it as a Bearer token: 
curl -H "Authorization: Bearer ts_live_..." \
  https://api.treeship.dev/v1/attest
See Authentication for full details on getting and managing API keys.
EndpointAuthentication
POST /v1/keys/requestPublic
POST /v1/keys/verifyPublic
GET /v1/keys/infoRequired
DELETE /v1/keysRequired
POST /v1/attestRequired
GET /v1/verify/:idPublic
GET /v1/agent/:slugPublic
GET /v1/pubkeyPublic

​
Response Format

All responses are JSON: 
{
  "attestation_id": "abc123-def456",
  "agent_slug": "my-agent",
  "action": "Processed request",
  ...
}

​
Errors

Errors return appropriate HTTP status codes:
StatusMeaning
400Bad request (invalid input)
401Unauthorized (missing/invalid API key)
404Not found
422Validation error
500Server error
Error response format: 
{
  "detail": "Error message here"
}

​
Rate Limits

  • Attestations: 100/minute per API key
  • Verification: 1000/minute per IP
  • Agent feed: 100/minute per IP

​
SDKs

  • Python: pip install treeship-sdk
  • CLI: npm install -g treeship-cli

​
Endpoints

Authentication

Get and manage API keys

API Keys

Key management endpoints

POST /v1/attest

Create a new attestation

GET /v1/verify/:id

Verify an attestation

GET /v1/agent/:slug

Get agent attestation feed

GET /v1/pubkey

Get public signing key