List a project's milestones
By date. Acceptance and invoice eligibility are separate facts, and tasks being done answers neither.
Scope: projects:read
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
agoo_rk_live_ | Agoo Reviews key, live mode: a business on Agoo Reviews on its own, on Reviews Business | Your servers only: the Reviews operations, for that business and the branches the key names |
agoo_rk_test_ | Agoo Reviews key, test mode | As above, on any level: it reads the business's reviews and checks every write without saving it |
agoo_ck_live_ | Check API key, live mode, for a Check API partner | Your servers only: the Checks operations (checks:read), billed per check |
agoo_ck_test_ | Check API key, test mode | As above, answering only the published test values, never billed |
Admins create keys in Console → Developers → API keys and choose each key's scopes; a business on Agoo Reviews on its own creates its keys in its business area on agoo.reviews, under Developers; a Check API partner creates its keys in its partner area on agoo.reviews. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: projects:read
project_id*string^proj_[0-7][0-9a-hjkmnp-tv-z]{25}$Its milestones.
application/json- response
data*array<>next_cursor*|Pass this as cursor to get the next page. null on the last page.
"b3BhcXVlLWN1cnNvcg"has_more*booleancurl -X GET 'https://api.agoohq.com/v1/projects/string/milestones'{ "data": [ { "id": "string", "project_id": "string", "title": "string", "description": "string", "due_on": "2019-08-24", "owner": {}, "acceptance": {}, "billing_eligible_at": "2019-08-24T14:15:22Z", "tasks": {}, "version": 0 } ], "next_cursor": "b3BhcXVlLWN1cnNvcg", "has_more": true}Move a project on POST
Approves, starts, holds, resumes, reopens or archives a project. Closing goes through its checklist, in the Console. At the plan's limit it's `project_limit_reached` (409), and the project stays as it was. Fires `project.state_changed`. **Scope:** `projects:write`
List a project's status updates GET
Newest first, by cursor. A published update never changes: a correction is a new one that points at it. **Scope:** `projects:read`