REST API Reference
Integrate with Monument through JSON REST endpoints secured by organisation API keys.
Base URL
https://api.monument.so/api/v1Authentication
Send X-API-Key: monument_... or Authorization: Bearer monument_....
Transport
Standard HTTP methods with JSON request and response bodies.
Quickstart
List the first 20 projects available to the API key's organisation.
curl 'https://api.monument.so/api/v1/projects?limit=20&offset=0' \
-H 'X-API-Key: monument_your_api_key'Create an API key
An organisation admin creates keys in Settings → API Keys. Copy the full secret when it is created: Monument shows it only once.
Responses and pagination
Successful JSON responses use a data envelope. List responses include a pagination object and accept offset-based limit and offset parameters where shown in the endpoint schema.
Rate limits
Keys default to 60 requests per minute and can have a custom per-minute limit. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset; limited requests return 429 with Retry-After.
Guides
Task-focused walkthroughs, from your first authenticated request to verifying webhook deliveries.
Getting an API key
Create a key in the app, send it on every request, and manage its access.
Your first request
List projects with cURL and fetch, then read the data and pagination envelope.
A real workflow end to end
Project to task to time entry to financials, chaining ids across calls.
Errors, pagination, and rate limits
Status codes, error shapes, offset paging, and the rate-limit headers.
Webhooks
Subscribe to events, receive signed POSTs, and verify the delivery signature.
Endpoint domains
Request schemas and response behaviour are extracted statically from the mounted REST v1 routes.
Allocations
Manage resource allocations and assignment progress.
Batch Operations
Create, update, or remove multiple records in one request.
Contacts
Manage client, consultant, and supplier contacts.
Expenses
Manage operational and project expense records.
Invoices
Manage invoices and their lifecycle.
Milestones
Manage project milestones and milestone status.
Projects
Manage projects represented by root tasks.
Rates
Manage organization rates and effective rate versions.
Reports
List report definitions and execute reports.
Resources
Manage staff resources, capacity, and organization membership records.
Task Financials
Read task financial summaries, revenue, and expenses.
Tasks
Manage tasks within projects and task hierarchies.
Time Entries
Create, update, list, and remove organization time entries.
Webhooks
Manage webhook subscriptions for integration events.