API Documentation
Welcome to the Stumpmic API. Our API allows you to programmatically access your workspace intelligence, manage agents, and integrate custom data sources.
Nexus API
Search, index, and retrieve insights from your connected data sources.
Forge API
Create, manage, and execute automated agent workflows.
Base URL
https://api.stumpmic.com/v1
Authentication
Stumpmic uses API keys to authenticate requests. You can view and manage your API keys in the dashboard settings.
Important: Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.
Authentication to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password.
curl https://api.stumpmic.com/v1/search \
-u sk_live_123456789:Nexus API
The Nexus API allows you to perform semantic searches across your indexed knowledge base.
Search
Returns a list of relevant documents and snippets based on the query.
curl -X POST https://api.stumpmic.com/v1/nexus/search \
-u sk_live_123456789: \
-d query="Q4 roadmap" \
-d limit=5Forge API
The Forge API enables you to programmatically manage agents and trigger workflows.
Trigger Agent
Triggers a specific agent to run immediately.
curl -X POST https://api.stumpmic.com/v1/forge/agents/{agent_id}/run \
-u sk_live_123456789:Webhooks
Listen for events on your Stumpmic account so your integration can automatically trigger reactions.
We send webhooks for events like agent.completed, index.updated, and more.