API Reference¶

import { ContioPartnerSDK } from '@contio/partner-sdk';

// For OAuth user operations
const { oauth, user } = ContioPartnerSDK.forUser({
  clientId: 'your-client-id',
  clientSecret: 'your-client-secret',
  redirectUri: 'https://your-app.com/callback'
});

// For API key admin operations
const { admin } = ContioPartnerSDK.forAdmin({
  apiKey: 'your-api-key'
});

// List meetings with optional filters
const meetings = await sdk.user.getMeetings({
  limit: 50,                           // Max results (default: 20)
  offset: 0,                           // Pagination offset
  start_date: '2024-01-01T00:00:00Z',  // Filter by start date
  end_date: '2024-12-31T23:59:59Z'     // Filter by end date
});

// Get specific meeting
const meeting = await sdk.user.getMeeting(meetingId);

// Get meeting notes/summary
const notes = await sdk.user.getMeetingNotes(meetingId);

// Get meeting transcript
const transcript = await sdk.user.getMeetingTranscript(meetingId);

// List action items with optional filters
const actionItems = await sdk.user.getActionItems({
  limit: 50,
  offset: 0,
  meeting_id: 'meeting-id',           // Filter by meeting
  is_completed: false,                 // Filter by status
  has_partner_assignment: true         // Only partner-assigned items
});

// Create action item
const newItem = await sdk.user.createActionItem({
  meeting_id: 'meeting-id',
  description: 'Follow up with client',
  due_date: '2024-01-08T17:00:00Z',   // RFC3339 format
  partner_context: {                   // Custom metadata
    crm_id: '12345',
    priority: 'high'
  }
});

// Update action item
const updated = await sdk.user.updateActionItem(actionItemId, {
  is_completed: true,
  partner_context: { resolution: 'Completed via email' }
});

// Delete action item
await sdk.user.deleteActionItem(actionItemId);

// Get authenticated user's profile
const profile = await sdk.user.getProfile();
// profile.workspace_id    - UUID of the user's workspace
// profile.workspace_name  - Display name of the workspace
// profile.workspace_role  - "WORKSPACE_OWNER" | "WORKSPACE_ADMIN" | "WORKSPACE_MEMBER"

// List user's workspaces
const workspaces = await sdk.user.getWorkspaces();

// List workflows
const workflows = await sdk.admin.getWorkflows({ limit: 50, offset: 0 });

// Create workflow
const workflow = await sdk.admin.createWorkflow({
  name: 'CRM Integration',
  description: 'Sync action items to CRM',
  trigger_type: 'action_item_created',
  actions: [{
    type: 'webhook',
    config: { url: 'https://your-crm.com/webhook', method: 'POST' }
  }]
});

// Update workflow
await sdk.admin.updateWorkflow(workflowId, { status: 'active' });

// Delete workflow
await sdk.admin.deleteWorkflow(workflowId);

// Get app info
const app = await sdk.admin.getApp();

// Update app details
await sdk.admin.updateApp({
  name: 'Updated App Name',
  webhook_url: 'https://new-webhook-url.com'
});

// Get usage statistics
const stats = await sdk.admin.getStats();

// List user connections
const connections = await sdk.admin.getConnections({
  limit: 50,
  offset: 0,
  status: 'active'  // 'active' | 'revoked'
});

// Revoke a connection
await sdk.admin.revokeConnection(connectionId);

// List webhook deliveries
const deliveries = await sdk.admin.getWebhookDeliveries({
  limit: 50,
  offset: 0,
  status: 'failed'  // 'pending' | 'success' | 'failed'
});

// Retry failed delivery
await sdk.admin.retryWebhookDelivery(deliveryId);

import { WebhookVerifier } from '@contio/partner-sdk';

const verifier = new WebhookVerifier(webhookSecret);
const result = verifier.verifySignature(payload, signature, timestamp);

if (result.isValid) {
  // Process webhook
} else {
  console.error('Invalid signature:', result.error);
}

import { ContioPartnerSDK } from '@contio/partner-sdk';

const sdk = new ContioPartnerSDK({
  oauth: {
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret',
    redirectUri: 'https://your-app.com/callback'
  },
  apiKey: 'your-api-key',
  baseURL: 'https://api.contio.ai',  // Custom API endpoint
  timeout: 60000                      // Request timeout in ms (default: 30000)
});