API Reference

# Authenticate with Bearer token curl -s -H "Authorization: Bearer sk_cintrico_YOUR_KEY" \ https://cintri.co/api/agents # Key format: sk_cintrico_[prefix]_[random] # Example: sk_cintrico_prod_a1b2c3d4e5f6

import { BossClient } from '@cintrico/sdk'; const boss = new BossClient({ apiKey: process.env.BOSS_API_KEY, baseUrl: 'https://cintri.co', }); // All subsequent calls are automatically authenticated const agents = await boss.agents.list();

// Register an outbound webhook const webhook = await boss.webhooks.create({ url: 'https://your-server.com/hooks/boss', events: ['document.published', 'task.completed', 'agent.flagged'], secret: 'whsec_your_signing_secret', studioId: 'stu_abc123', // Optional: scope to a specific studio active: true, }); // Verify webhook signatures in your handler import { verifySignature } from '@cintrico/sdk'; app.post('/hooks/boss', (req, res) => { const isValid = verifySignature( req.body, req.headers['x-boss-signature'], 'whsec_your_signing_secret' ); if (!isValid) return res.status(401).send('Invalid signature'); const event = req.body; console.log(event.type, event.data); res.status(200).send('OK'); });

// Robust error handling with retry import { BossClient, BossError } from '@cintrico/sdk'; const boss = new BossClient({ apiKey: process.env.BOSS_API_KEY }); async function sendWithRetry(message: string, retries = 3): Promise<any> { for (let attempt = 1; attempt <= retries; attempt++) { try { return await boss.chat.send({ studioId: 'stu_abc123', agentId: 'ori', message, }); } catch (error) { if (error instanceof BossError) { // Don't retry client errors (4xx) if (error.status >= 400 && error.status < 500 && error.status !== 429) { throw error; } // Retry on rate limit with Retry-After header if (error.status === 429) { const retryAfter = error.headers['retry-after'] ?? 5; console.log(`Rate limited. Retrying in ${retryAfter}s...`); await new Promise(r => setTimeout(r, retryAfter * 1000)); continue; } // Retry on server errors with exponential backoff if (error.status >= 500) { const delay = Math.min(1000 * 2 ** attempt, 30000); console.log(`Server error ${error.status}. Retry ${attempt}/${retries} in ${delay}ms`); await new Promise(r => setTimeout(r, delay)); continue; } } throw error; } } throw new Error('Max retries exceeded'); }