API Reference

Tendrex provides two APIs: this internal API used by the web app (session-based authentication via Microsoft SSO), and a Public API for external integrations (API key authentication).

Base URL

https://app.tendrex.co.uk/api

Authentication

Tendrex uses Microsoft Entra ID (Azure AD) SSO for authentication. Session-based authentication is used across all endpoints.

Method	Endpoint	Description
GET	/auth/login	Initiate Microsoft SSO login
GET	/auth/callback	SSO callback handler
GET	/auth/me	Get current user info and role
POST	/auth/logout	End session

Endpoints

Documents

Method	Endpoint	Description
GET	/documents	List all documents
POST	/documents/upload	Upload a new document (PDF or Word)
GET	/documents/:id/preview	Preview document content
DELETE	/documents/:id	Delete a document
GET	/documents/tags	List all document tags
POST	/documents/tags	Create a new document tag
DELETE	/documents/tags/:id	Delete a document tag
GET	/documents/:id/tags	Get tags for a document
PUT	/documents/:id/tags	Update tags on a document

Tenders

Method	Endpoint	Description
GET	/tenders	List all tenders
POST	/tenders	Create a new tender
GET	/tenders/:id	Get tender details
PUT	/tenders/:id	Update tender metadata
DELETE	/tenders/:id	Delete a tender
PATCH	/tenders/:id/status	Update tender status
POST	/tenders/:id/submit	Record tender submission
POST	/tenders/:id/outcome	Record tender outcome (awarded/lost)

Question Processing

Method	Endpoint	Description
POST	/process/upload	Upload a question file (Excel or Word)
GET	/process/status/:session_id	Get processing progress
POST	/process/run	Start AI answer generation
GET	/process/results/:session_id	Fetch generated answers

Answers

Method	Endpoint	Description
GET	/tenders/:id/answers	List answers for a tender
POST	/review/:id/approve	Approve an answer
POST	/review/:id/reject	Reject an answer with comment
POST	/review/:id/edit	Edit and approve an answer
POST	/review/:id/provide	Provide a custom answer
POST	/review/:id/assign	Assign to a team or user
POST	/review/bulk/approve	Bulk approve answers
POST	/review/bulk/reject	Bulk reject answers
POST	/review/bulk/assign	Bulk assign answers
GET	/review/:id/versions	Get answer version history

Answer Library (Canonical Store)

Method	Endpoint	Description
GET	/canonical	List approved answers (with search and filters)
POST	/canonical	Add an approved answer
PUT	/canonical/:id	Update an answer
DELETE	/canonical/:id	Delete an answer
GET	/canonical/search	Semantic search across the library

Users

Method	Endpoint	Description
GET	/users	List users in your organisation
POST	/users/invite	Invite a user by email with role
GET	/users/me/queue	Get current user’s question queue
PUT	/users/:id	Update user details or role
DELETE	/users/:id	Remove a user

Teams

Method	Endpoint	Description
GET	/teams	List all teams
POST	/teams	Create a new team
PUT	/teams/:id	Update a team
DELETE	/teams/:id	Delete a team
POST	/teams/:id/members	Add a member to a team
DELETE	/teams/:id/members/:user_id	Remove a member from a team

Audit

Method	Endpoint	Description
GET	/audit	List org-wide audit logs (with filters and pagination)
GET	/audit/:entity_type/:entity_id	Get audit trail for a specific entity

AI Assist

Method	Endpoint	Description
POST	/ai-assist/:id/improve	Improve grammar and clarity
POST	/ai-assist/:id/expand	Expand with detail and examples
POST	/ai-assist/:id/condense	Condense to key points
POST	/ai-assist/:id/formal	Rewrite in formal tone
POST	/ai-assist/:id/bullets	Convert to bullet point format
POST	/ai-assist/:id/strengthen	Strengthen with evidence

Comments

Method	Endpoint	Description
GET	/review/:id/comments	List comments on an answer
POST	/review/:id/comments	Add a comment (with optional highlight)
POST	/review/:id/comments/:comment_id/reply	Reply to a comment
PATCH	/review/:id/comments/:comment_id/resolve	Resolve a comment thread

Compliance

Method	Endpoint	Description
GET	/tenders/:id/compliance	List compliance items for a tender
POST	/tenders/:id/compliance	Add a compliance item
PUT	/compliance/:id	Update a compliance item
DELETE	/compliance/:id	Delete a compliance item
POST	/compliance/:id/evidence	Upload evidence for a compliance item
POST	/tenders/:id/compliance/template	Apply a pre-built compliance template

Templates

Method	Endpoint	Description
GET	/templates	List tender templates
POST	/templates	Create a template
GET	/templates/:id	Get template details
PUT	/templates/:id	Update a template
DELETE	/templates/:id	Delete a template
POST	/templates/:id/apply	Apply template to a new tender
POST	/tenders/:id/save-template	Create template from existing tender

Dashboard

Method	Endpoint	Description
GET	/dashboard	Get role-based dashboard metrics
GET	/dashboard/dashboards	List user’s dashboards
POST	/dashboard/dashboards	Create a custom dashboard
PUT	/dashboard/dashboards/:id	Update dashboard layout and widgets
DELETE	/dashboard/dashboards/:id	Delete a custom dashboard

Note

Dashboard metrics vary by role. Admins see org-wide stats, Bid Managers see project overviews, and SMEs see their personal queue. Over 30 widget types are available.

Notifications

Method	Endpoint	Description
GET	/notifications	List notifications for current user
PATCH	/notifications/:id/read	Mark a notification as read
POST	/notifications/read-all	Mark all notifications as read

Webhooks

Method	Endpoint	Description
GET	/webhooks	List webhooks
POST	/webhooks	Create a webhook
PUT	/webhooks/:id	Update a webhook
DELETE	/webhooks/:id	Delete a webhook
POST	/webhooks/:id/test	Send a test event to the webhook
GET	/webhooks/:id/deliveries	List delivery history

API Keys

Method	Endpoint	Description
GET	/api-keys	List API keys for your organisation
POST	/api-keys	Create a new API key with scopes
DELETE	/api-keys/:id	Delete an API key

Errors

All errors return a JSON body with error and message fields:

{
  "error": "not_found",
  "message": "Tender not found"
}