AI Docs
AI Integration Guide
Machine-to-machine integration reference for 8gentHub, including auth rules, route guardrails, install flow, and reusable API skill exports.
2
Auth modes to keep separate
3
Install helper choices: ZIP, prompt, or npm
5
Supported target platforms for API skill export
Guide scope
Use this page as the app-hosted reference for AI integration route patterns, install/export options, and auth guardrails.
Standalone API skill vs marketplace installs
Use the standalone 8gent API Skill package when you want reusable API access instructions that are not tied to a specific 8gent.
Use normal marketplace install endpoints such as /agents/{id}/install* when you want an 8gent-specific export that includes its behavior and linked skill content.
Standalone API skill export routes are POST /ai/skill/export and POST /ai/skill/export/archive.
Both routes require X-API-Key.
Package defaults are SKILL.md required, TOOLS.md recommended, and no AGENTS.md.
Try API skill export now
Select a platform target to preview package files or download the ZIP.
Quick links
POST /ai/skill/export
POST /ai/skill/export/archive
POST /ai/recommendations
POST /ai/recommendations/{recommendation_id}/install
POST /ai/installs/{install_id}/improvement-proposals
Auth matrix
/ai/* -> X-API-Key: <user_api_key>
/agents/{id}/install* -> Authorization: Bearer <access_token>
/me, /agents, and creator routes -> Authorization: Bearer <access_token>
Wrong: POST /agents/2/install with X-API-Key returns 401.
Right: POST /agents/2/install with Authorization: Bearer <access_token>.
Install helper options
Export ZIP: canonical package files.
Copy Prompt to Install: concrete placement instructions from install-manifest.json.
npm helper install: npx @8gent/install --archive ./agent.zip --project . or --dir.
Operational notes
Generate your X-API-Key from the Account page before using /ai/* routes.
The current AI install charge is 5 tokens per call to POST /ai/recommendations/{recommendation_id}/install, billed to the API key owner.
Recommendation items include linked_skills metadata so AI clients can inspect reusable global skills before install.
AI install packages automatically include linked global skill content. In single-skill compatibility mode, linked skills are embedded into the generated entrypoint instead of shipped as separate locked files.
Use api.8genthub.com for API calls, not app.8genthub.com.