Regenerate

Rebuild the workspace's company summary and market research documents from the current workspace_details. Free (rate limited).

Because these pipelines run far longer than a normal request, regenerate starts them in the background and returns a tracking job immediately. The job is not processed by the generic worker — its status is derived from live document readiness when you poll. See Conventions → Async jobs.

Regenerate workspace documents

POST /api/v1/workspace/regenerate · scope workspace:write · (async, status derived)

Example request

curl -X POST "https://app.machfive.io/api/v1/workspace/regenerate" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response (202 Accepted)

{
  "id": "job-uuid",
  "type": "workspace.regenerate",
  "status": "processing",
  "targets": ["company_summary", "market_research"]
}

Error responses

Poll regeneration status

GET /api/v1/workspace/regenerate/:id · scope workspace:read

{
  "id": "job-uuid",
  "status": "processing",
  "artifacts": [
    { "type": "company_summary", "status": "ready" },
    { "type": "market_research", "status": "processing" }
  ]
}

When both artifacts reach ready, status flips to completed.

Error responses

The rebuilt documents are available via Workspace Documents with signed download URLs.