Skip to content
Mettle API — Dev Integration Guide
This guide helps you integrate with our secure taxonomy API to power mental performance workflows like session summaries, SOAP notes, or training suggestions.
How to Access the API
Base URL:
https://taxonomy-api-xyz.onrender.com
Replace taxonomy-api-xyz with the actual subdomain of your deployed Render app.
Required Header
Every request must include your API key:
x-api-key: coach-key-456
Example with curl
curl https://taxonomy-api-xyz.onrender.com/recommendations \
-H "x-api-key: your-api-key-goes-here"
Example in JavaScript
fetch("https://taxonomy-api-xyz.onrender.com/recommendations", {
headers: {
"x-api-key": "your-api-key-goes-here"
}
});
📌 Key Endpoints
1. Get Core Recommendations
Returns a short list of core skills used across athlete development flows.
GET /recommendations
Sample Response:
[
{ "name": "Self-Awareness", "category": "Capacity" },
{ "name": "Stress Management", "category": "Capacity" }
]
2. Available Recommendation Types
Returns a set of predefined recommendation tags you can use.
GET /recommendations/types
Sample Response:
[
"confidence_boost",
"injury_recovery",
"focus_primer"
]
3. List Skills by Category
Given a known category name, returns all the available skills.
GET /categories/{category_name}/skills
Example:
GET /categories/Capacity/skills
Response:
[
{ "name": "Self-Awareness", "has_applications": true },
{ "name": "Stress Management", "has_applications": true }
]
4. Skill or Application Lookup (by ID)
Use this when you already know the id (e.g. from your AI pipeline) and want details.
GET /skill-lookup?id={skill_id}
Example:
GET /skill-lookup?id=injury_awareness
Response:
{
"id": "injury_awareness",
"name": "Injury Awareness",
"parent_skill": "Self-Awareness",
"category": "Capacity",
"super_category": "Foundational Qualities",
"description": "...",
"indicators": [ "...", "..." ]
}
✅ Access Level
You’ve been granted read:recommendations scope.
This means:
Need a new skill added? Ask us.
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.