API
Full programmatic access to Agents. Execute workflows, manage records, and integrate with any system.
import { Darkmatter } from "@darkmatter/sdk";
const dm = new Darkmatter({
apiKey: process.env.DARKMATTER_API_KEY,
});
// Execute a workflow
const execution = await dm.workflows.execute({
workflowId: "wf_abc123",
inputs: {
email: "user@example.com",
action: "welcome",
},
});
// Wait for completion
const result = await execution.wait();
console.log(result.outputs);
// Query records
const companies = await dm.records.companies.list({
filter: { industry: "Technology" },
limit: 10,
});Key endpoints
/v1/workflows/:id/executeExecute a workflow with inputs/v1/executions/:idGet execution status and outputs/v1/records/peopleList people records with filters/v1/records/companiesCreate a new company record/v1/integrationsList available integrations/v1/webhooksRegister a webhook endpointDeveloper-first API
RESTful API
Clean, predictable REST endpoints. CRUD operations for workflows, records, and executions.
Webhooks
Receive real-time notifications for any event. Workflow completions, record changes, and more.
SDK support
Official SDKs for TypeScript, Python, and Go. Get started in minutes.
Rate limiting
Generous rate limits with clear headers. Automatic retry with exponential backoff.
Authentication
API keys and OAuth 2.0 support. Scoped permissions for fine-grained access control.
Versioning
Stable API versions with long deprecation cycles. Never break your integrations.
Simple pricing
7-day free trial. No credit card required.
- 500 runs/month
- All integrations
- Use your own API keys
- 1,000 credits/month
- Unlimited runs
- All frontier models
Frequently asked questions
How do I authenticate API requests?
Use API keys or OAuth 2.0 tokens in the Authorization header. API keys can be created in your workspace settings with scoped permissions.
What are the rate limits?
Rate limits depend on your plan: Team gets 100 req/min, Pro gets 500 req/min, Enterprise gets custom limits. Rate limit headers are included in every response.
Is there a sandbox environment?
Yes. All workspaces include a sandbox mode where API calls don't affect production data or consume credits. Use the x-sandbox: true header to enable it.
Are there official SDKs?
Yes. We provide official SDKs for TypeScript/JavaScript, Python, and Go. They handle authentication, retries, and type safety automatically.
Ready to integrate?
Get your API key and start building in minutes.