Recalculate all estimates for a project component
Recalculates time estimates for all items (epics and non-epics) within a project component. This includes:
- Recalculating individual item estimates based on timeFrame and question multipliers/extra hours
- Recalculating epic estimates by summing their children’s estimates
- Updating the component’s totalTimeFrame
- Respecting visibility conditions (items with invalid conditions are excluded)
Items are processed bottom-up (children first, then parents) to ensure accurate calculations. Only components that belong to the specified project can be recalculated through this endpoint.
POST
/projects/{projectId}/components/{id}/recalculate-estimatesAuthorization
AuthorizationOAuth2 access token · headerrequiredScopes:
api:writeor
AuthorizationBearer token (JWT) · headerrequiredPath parameters
projectIdstringrequiredProject UUID
idstringrequiredComponent UUID
Responses
200Estimates recalculated successfully
successbooleanrequiredOperation success flag
400Invalid projectId or component ID format (not a valid UUID)
401Unauthorized - Invalid or missing authentication token
403Insufficient permissions to manage components or no access to project
404Component not found or does not belong to the specified project
Request
curl -X POST "https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/components/e57dc37b-7693-4d06-b49c-17084b773aff/recalculate-estimates" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"const response = await fetch("https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/components/e57dc37b-7693-4d06-b49c-17084b773aff/recalculate-estimates", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
}
});import requests
response = requests.post(
"https://leadtime.app/api/public/projects/a47dc37b-7693-4d06-b49c-17084b773aff/components/e57dc37b-7693-4d06-b49c-17084b773aff/recalculate-estimates",
headers={
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
)Response
{
"success": true
}Invalid projectId or component ID format (not a valid UUID)
Unauthorized - Invalid or missing authentication token
Insufficient permissions to manage components or no access to project
Component not found or does not belong to the specified project