A deal’s stage history
Every stage a trattativa has passed through, newest first: when it entered, when it left, whether the move was forward or a regression, and who or what moved it. This is what answers «quanto è rimasta ferma in Negoziazione», «quante volte è tornata indietro» and «chi l’ha spostata» — crm_get_deal shows only the last few moves. Bounded, not paged, so there is no cursor; detailed adds the amount, probability and forecast date the deal carried at each entry.
Examples
- How long has this deal been stuck in negotiation? GET /api/v1/rest/crm/deals/22222222-3333-4444-8555-666666666666/history
- Show me every move on it, with the figures at the time GET /api/v1/rest/crm/deals/22222222-3333-4444-8555-666666666666/history?limit=50&response_format=detailed
Request
- Base URL: https://api.custodo.ai
- URL: https://api.custodo.ai/api/v1/rest/crm/deals/{id}/history
- Auth: HTTP bearer
Path parameters
The deal id, from crm_list_deals or crm_get_deal.
Query parameters
Rows to return, newest first, 1–100. Default 20. Bounded rather than paged: there is no cursor.
concise (default) returns the fields you need to answer a question; detailed adds related records and costs more context.
Headers
The organisation to act in. An API key is bound to exactly one, so this is optional for a key and must match the one it was minted for.
Response
Done. data is the tool’s own answer.
Changes
No recorded changes to this operation across all 1 revision of this API.