Skip to content

API Endpoints

Base URL: https://api.zubbl.in

All requests require authentication via Bearer token: 

Authorization: Bearer zubbl_<your_key>

Core Endpoints

Health Check

GET /health
Returns API status. No auth required.

Ingest Trajectory

POST /ingest
Record an agent execution for learning.

{
  "trajectory_id": "traj-001",
  "tenant_id": "your_tenant_id",
  "task_description": "Review code for security issues",
  "steps": [
    {
      "action": "scan",
      "tool_name": "semgrep",
      "tool_input": {"rules": "owasp"},
      "tool_output": "2 findings"
    }
  ],
  "status": "success",
  "total_latency_ms": 3200
}

Query Policy

GET /query?task=code_review
Get recommended strategies for a task type.

Submit Feedback

POST /feedback
Rate a trajectory to improve learning.

{
  "feedback_id": "fb-001",
  "trajectory_id": "traj-001",
  "rating": 0.9,
  "source": "human",
  "comment": "Excellent review"
}

Usage Stats

GET /usage
Credit balance, trajectory counts, and success rate.

Improvement Score

GET /improvement
How much the SDK improved your agent performance over time.

Skill Graph (Cloud Pro+)

Endpoint Method Description
/graph/stats GET Node/relationship counts
/graph/skills GET List skills
/graph/skills POST Create a skill
/graph/recommendations/{task} GET Pattern recommendations
/graph/skill-gaps/{agent}/{task} GET Skill gap analysis

Vector Search (Cloud Pro+)

Endpoint Method Description
/vector/similar GET Find similar past trajectories
/vector/patterns GET Find successful patterns

Training (Cloud Pro+)

Endpoint Method Description
/training/stats GET Training status
/training/trigger POST Trigger training run

Billing

Endpoint Method Description
/billing/checkout POST Create upgrade checkout
/billing/subscription GET Current subscription

Error Codes

Code Meaning
200 Success
400 Invalid request
401 Missing or invalid API key
429 Rate limited
500 Server error

Interactive Docs