WorkAndGo API
Documentation

Build integrations with the WorkAndGo platform. All endpoints are available under /api/ with JSON request and response bodies.

API Endpoint Groups

The WorkAndGo API is organised into logical groups. Full request/response schemas are available in the interactive Swagger docs.

🔒

Authentication

OAuth 2.0 flows for Google and Microsoft, session management, dev-login for local development, and user profile endpoints.

/api/auth/*
💬

Channels

Create, list, update, and delete channels. Join and leave channels, manage members, and track unread counts per user.

/api/channels/*
📩

Messages

Send and retrieve messages with pagination. Full-text search, emoji reactions, threaded replies, file attachments, and pinning.

/api/messages/*
📞

Meetings

Schedule meetings with calendar integration. Start Pulse audio/video calls, retrieve transcripts, and manage meeting notes.

/api/pulse/*

Tasks

Full task CRUD with priorities, assignees, and due dates. Set dependencies between tasks. Create tasks directly from chat messages.

/api/tasks/*
🏢

HR

Attendance clock-in/out with geo-fencing, leave requests and approvals, roster management, and secure document vault access.

/api/hr/*

Webhooks

Register webhook endpoints to receive real-time events. Trigger automated workflows on message, task, or HR events.

/api/webhooks/*
🔗

Suite Integration

Cross-app token validation for the Interetail suite (SignAndGo, ShareAndGo). Publish and subscribe to inter-app events.

/api/suite/*

Authentication

All API requests require authentication via one of the following methods:

  • Session cookie (session_token) set after OAuth login
  • API key passed in the X-API-Key header
  • WebSocket ticket for real-time connections (/api/auth/ws-ticket)

API keys can be generated from the Settings page in the WorkAndGo dashboard. Keys are scoped to your organisation.

Rate Limiting

To ensure fair usage, the API enforces the following rate limits:

  • Standard endpoints: 100 requests per minute
  • Search endpoints: 30 requests per minute
  • File uploads: 20 requests per minute
  • WebSocket connections: 5 concurrent per user

Rate limit headers (X-RateLimit-Remaining) are included in every response. Contact us if you need higher limits.

Need help integrating?

Our team is here to help you build on WorkAndGo. Reach out for technical guidance, partnership enquiries, or custom API access.

Contact [email protected]