Change Status

Move projects through your investment pipeline by updating their status, phase, and stage. Track decision-making with comments and reasons, with automatic webhook notifications for pipeline changes.

Endpoint

POST https://api.kruncher.ai/api/integration/project/status

Headers

Header	Required	Description
`Authorization`	Yes	Your API key (format: `YOUR_API_KEY`)
`Content-Type`	Yes	Must be `application/json`

Request Body

Field	Type	Required	Description
`projectId`	string	Yes	Unique project identifier
`projectstatusId`	string	Yes	Status ID from `/api/config`
`projectphaseId`	string	Yes	Phase ID from `/api/config`
`projectstageId`	string	No	Stage ID (if applicable)
`reasonTakenArray`	array	No	Array of reason objects with `id` and `name`
`comment`	string	No	Comment explaining the change (max 1000 chars)

Getting Required IDs

To find the correct status, phase, and stage IDs:

Call Config Endpoint: GET /api/config
Find Status: Look in projectstatus array for code (e.g., active, dropped)
Find Phase: Look in projectphases array for code (e.g., invested, rejected)
Extract ID: Use the id field from matching objects

Common Status Codes

Code	Status	Use Case
`active`	Active	Currently evaluating
`screening`	Screening	Initial review
`dropped`	Dropped	No longer pursuing
`archived`	Archived	Historical record

Common Phase Codes

Code	Phase	Meaning
`undecided`	Undecided	Not yet decided
`duediligence`	Due Diligence	Active investigation
`invested`	Invested	Investment completed
`rejected`	Rejected	Opportunity declined
`exited`	Exited	Investment realized

Code Examples

JavaScript/TypeScript

Basic

CODE

const API_KEY = "YOUR_API_KEY_HERE";
 
const response = await fetch("https://api.kruncher.ai/api/integration/project/status", {
  method: "POST",
  headers: {
    "Authorization": `${API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    projectId: "521a93a6-091d-4943-ba13-7c1a654a14ae",
    projectstatusId: "status_active_id",
    projectphaseId: "phase_invested_id",
    comment: "Moving to invested phase based on board decision"
  })
});
 
const result = await response.json();
console.log("Status updated:", result);

Result: Updates project status and phase with a comment.

With Reasons

CODE

const API_KEY = "YOUR_API_KEY_HERE";
const BASE_URL = "https://api.kruncher.ai/api";
 
async function updateProjectStatus(
  projectId,
  statusCode,
  phaseCode,
  reasons = [],
  comment = ""
) {
  // Step 1: Get config to find IDs
  const configResponse = await fetch(`${BASE_URL}/config`, {
    headers: {
      "Authorization": `${API_KEY}`,
      "Content-Type": "application/json"
    }
  });
 
  const config = await configResponse.json();
 
  // Find status ID
  const status = config.projectstatus?.find(s => s.code === statusCode);
  if (!status) {
    throw new Error(`Status code '${statusCode}' not found`);
  }
 
  // Find phase ID
  const phase = config.projectphases?.find(p => p.code === phaseCode);
  if (!phase) {
    throw new Error(`Phase code '${phaseCode}' not found`);
  }
 
  // Step 2: Update status
  const updateResponse = await fetch(`${BASE_URL}/integration/project/status`, {
    method: "POST",
    headers: {
      "Authorization": `${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      projectId,
      projectstatusId: status.id,
      projectphaseId: phase.id,
      reasonTakenArray: reasons,
      comment
    })
  });
 
  if (!updateResponse.ok) {
    throw new Error(`Status update failed: ${updateResponse.statusText}`);
  }
 
  return await updateResponse.json();
}
 
// Usage
const reasons = [
  { id: "reason_1", name: "Strong team" },
  { id: "reason_2", name: "Large market opportunity" }
];
 
const result = await updateProjectStatus(
  "521a93a6-091d-4943-ba13-7c1a654a14ae",
  "active",
  "invested",
  reasons,
  "Board approved investment of $5M in Series A"
);
 
console.log("Project status updated:", result);

Result: Automatically looks up IDs and updates status with reasons.

Advanced

CODE

const API_KEY = "YOUR_API_KEY_HERE";
const BASE_URL = "https://api.kruncher.ai/api";
 
class ProjectStatusManager {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseURL = BASE_URL;
    this.configCache = null;
    this.lastConfigFetch = null;
    this.configTTL = 3600000; // 1 hour
  }
 
  async getConfig(forceRefresh = false) {
    const now = Date.now();
 
    if (!forceRefresh && this.configCache && (now - this.lastConfigFetch < this.configTTL)) {
      return this.configCache;
    }
 
    const response = await fetch(`${this.baseURL}/config`, {
      headers: {
        "Authorization": `${this.apiKey}`,
        "Content-Type": "application/json"
      }
    });
 
    if (!response.ok) {
      throw new Error("Failed to fetch config");
    }
 
    this.configCache = await response.json();
    this.lastConfigFetch = now;
 
    return this.configCache;
  }
 
  async updateStatus(projectId, updates) {
    const config = await this.getConfig();
 
    // Resolve status ID
    const status = config.projectstatus?.find(s => s.code === updates.status);
    if (!status) {
      throw new Error(`Invalid status: ${updates.status}`);
    }
 
    // Resolve phase ID
    const phase = config.projectphases?.find(p => p.code === updates.phase);
    if (!phase) {
      throw new Error(`Invalid phase: ${updates.phase}`);
    }
 
    const payload = {
      projectId,
      projectstatusId: status.id,
      projectphaseId: phase.id
    };
 
    if (updates.reasons && updates.reasons.length > 0) {
      payload.reasonTakenArray = updates.reasons;
    }
 
    if (updates.comment) {
      payload.comment = updates.comment;
    }
 
    const response = await fetch(`${this.baseURL}/integration/project/status`, {
      method: "POST",
      headers: {
        "Authorization": `${this.apiKey}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify(payload)
    });
 
    if (!response.ok) {
      const error = await response.json().catch(() => ({ message: response.statusText }));
      throw new Error(`Status update failed: ${error.message || error.description}`);
    }
 
    return await response.json();
  }
 
  async moveToScreening(projectId, comment = "") {
    return await this.updateStatus(projectId, {
      status: "screening",
      phase: "undecided",
      comment: comment || "Moved to screening phase"
    });
  }
 
  async moveToDueDiligence(projectId, reasons = [], comment = "") {
    return await this.updateStatus(projectId, {
      status: "active",
      phase: "duediligence",
      reasons,
      comment: comment || "Moved to due diligence"
    });
  }
 
  async moveToInvested(projectId, reasons = [], comment = "") {
    return await this.updateStatus(projectId, {
      status: "active",
      phase: "invested",
      reasons,
      comment: comment || "Investment completed"
    });
  }
 
  async reject(projectId, reason = "") {
    return await this.updateStatus(projectId, {
      status: "dropped",
      phase: "rejected",
      comment: reason || "Opportunity rejected"
    });
  }
 
  async archive(projectId, comment = "") {
    return await this.updateStatus(projectId, {
      status: "archived",
      phase: "exited",
      comment: comment || "Project archived"
    });
  }
 
  async getAvailableStatuses() {
    const config = await this.getConfig();
    return config.projectstatus || [];
  }
 
  async getAvailablePhases() {
    const config = await this.getConfig();
    return config.projectphases || [];
  }
}
 
// Usage
const manager = new ProjectStatusManager("YOUR_API_KEY_HERE");
 
// Move to screening
await manager.moveToScreening("proj_123", "Initial review scheduled");
 
// Move to due diligence with reasons
const reasons = [
  { id: "reason_1", name: "Strong team" },
  { id: "reason_2", name: "Large TAM" }
];
 
await manager.moveToDueDiligence(
  "proj_123",
  reasons,
  "Approved for deep dive by partners"
);
 
// Move to invested
await manager.moveToInvested(
  "proj_123",
  reasons,
  "Board approved $5M Series A investment"
);
 
// Reject
await manager.reject("proj_123", "Market timing concerns");
 
// Archive
await manager.archive("proj_123", "Acquired by competitor");
 
// Get available options
const statuses = await manager.getAvailableStatuses();
const phases = await manager.getAvailablePhases();
 
console.log("Available statuses:", statuses.map(s => s.code));
console.log("Available phases:", phases.map(p => p.code));

Result: Full-featured manager with helper methods for common workflows.

Python

Basic

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
url = "https://api.kruncher.ai/api/integration/project/status"
 
headers = {
    "Authorization": f"{API_KEY}",
    "Content-Type": "application/json"
}
 
data = {
    "projectId": "521a93a6-091d-4943-ba13-7c1a654a14ae",
    "projectstatusId": "status_active_id",
    "projectphaseId": "phase_invested_id",
    "comment": "Moving to invested phase based on board decision"
}
 
response = requests.post(url, headers=headers, json=data)
 
if response.status_code == 200:
    print("Status updated:", response.json())
else:
    print(f"Error: {response.status_code} {response.text}")

Result: Updates project status and phase.

With Reasons

CODE

import requests
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
def update_project_status(project_id, status_code, phase_code, reasons=None, comment=""):
    """
    Update status and phase.
    
    Args:
        project_id: The project ID
        status_code: Status code (e.g., 'active', 'dropped')
        phase_code: Phase code (e.g., 'invested', 'rejected')
        reasons: List of reason dicts with 'id' and 'name'
        comment: Comment explaining the change
    """
    headers = {
        "Authorization": f"{API_KEY}",
        "Content-Type": "application/json"
    }
    
    # Get config
    config_response = requests.get(f"{BASE_URL}/config", headers=headers)
    config_response.raise_for_status()
    config = config_response.json()
    
    # Find status ID
    status = next(
        (s for s in config.get('projectstatus', []) if s.get('code') == status_code),
        None
    )
    if not status:
        raise ValueError(f"Status code '{status_code}' not found")
    
    # Find phase ID
    phase = next(
        (p for p in config.get('projectphases', []) if p.get('code') == phase_code),
        None
    )
    if not phase:
        raise ValueError(f"Phase code '{phase_code}' not found")
    
    # Update status
    payload = {
        "projectId": project_id,
        "projectstatusId": status['id'],
        "projectphaseId": phase['id']
    }
    
    if reasons:
        payload['reasonTakenArray'] = reasons
    
    if comment:
        payload['comment'] = comment
    
    response = requests.post(
        f"{BASE_URL}/integration/project/status",
        headers=headers,
        json=payload
    )
    response.raise_for_status()
    
    return response.json()
 
# Usage
reasons = [
    {"id": "reason_1", "name": "Strong team"},
    {"id": "reason_2", "name": "Large market opportunity"}
]
 
result = update_project_status(
    "521a93a6-091d-4943-ba13-7c1a654a14ae",
    "active",
    "invested",
    reasons,
    "Board approved investment of $5M in Series A"
)
 
print("Status updated:", result)

Result: Automatic ID lookup with reason tracking.

Advanced

CODE

import requests
import time
from typing import Dict, List, Optional
from enum import Enum
 
API_KEY = "YOUR_API_KEY_HERE"
BASE_URL = "https://api.kruncher.ai/api"
 
class ProjectStatus(str, Enum):
    ACTIVE = "active"
    SCREENING = "screening"
    DROPPED = "dropped"
    ARCHIVED = "archived"
 
class ProjectPhase(str, Enum):
    UNDECIDED = "undecided"
    DUE_DILIGENCE = "duediligence"
    INVESTED = "invested"
    REJECTED = "rejected"
    EXITED = "exited"
 
class ProjectStatusManager:
    """Manage project pipeline status and phases."""
    
    def __init__(self, api_key: str = API_KEY):
        self.api_key = api_key
        self.base_url = BASE_URL
        self.session = requests.Session()
        self.session.headers.update({
            "Authorization": f"{api_key}",
            "Content-Type": "application/json"
        })
        
        self.config_cache = None
        self.last_config_fetch = None
        self.config_ttl = 3600  # 1 hour
    
    def fetch_config(self, force_refresh: bool = False) -> Dict:
        """Fetch and cache configuration."""
        now = time.time()
        
        if not force_refresh and self.config_cache and self.last_config_fetch:
            if (now - self.last_config_fetch) < self.config_ttl:
                return self.config_cache
        
        response = self.session.get(f"{self.base_url}/config")
        response.raise_for_status()
        
        self.config_cache = response.json()
        self.last_config_fetch = now
        
        return self.config_cache
    
    def get_status_id(self, status_code: str) -> str:
        """Get status ID by code."""
        config = self.fetch_config()
        status = next(
            (s for s in config.get('projectstatus', []) if s.get('code') == status_code),
            None
        )
        if not status:
            raise ValueError(f"Status code '{status_code}' not found")
        return status['id']
    
    def get_phase_id(self, phase_code: str) -> str:
        """Get phase ID by code."""
        config = self.fetch_config()
        phase = next(
            (p for p in config.get('projectphases', []) if p.get('code') == phase_code),
            None
        )
        if not phase:
            raise ValueError(f"Phase code '{phase_code}' not found")
        return phase['id']
    
    def update_status(
        self,
        project_id: str,
        status_code: str,
        phase_code: str,
        reasons: Optional[List[Dict]] = None,
        comment: Optional[str] = None
    ) -> Dict:
        """
        Update status and phase.
        
        Args:
            project_id: The project ID
            status_code: Status code from ProjectStatus enum
            phase_code: Phase code from ProjectPhase enum
            reasons: List of reason dicts
            comment: Explanation comment
        
        Returns:
            API response
        """
        payload = {
            "projectId": project_id,
            "projectstatusId": self.get_status_id(status_code),
            "projectphaseId": self.get_phase_id(phase_code)
        }
        
        if reasons:
            payload['reasonTakenArray'] = reasons
        
        if comment:
            payload['comment'] = comment
        
        response = self.session.post(
            f"{self.base_url}/integration/project/status",
            json=payload
        )
        response.raise_for_status()
        
        return response.json()
    
    def move_to_screening(
        self,
        project_id: str,
        comment: Optional[str] = None
    ) -> Dict:
        """Move project to screening phase."""
        return self.update_status(
            project_id,
            ProjectStatus.SCREENING,
            ProjectPhase.UNDECIDED,
            comment=comment or "Moved to screening phase"
        )
    
    def move_to_due_diligence(
        self,
        project_id: str,
        reasons: Optional[List[Dict]] = None,
        comment: Optional[str] = None
    ) -> Dict:
        """Move project to due diligence phase."""
        return self.update_status(
            project_id,
            ProjectStatus.ACTIVE,
            ProjectPhase.DUE_DILIGENCE,
            reasons=reasons,
            comment=comment or "Moved to due diligence"
        )
    
    def move_to_invested(
        self,
        project_id: str,
        reasons: Optional[List[Dict]] = None,
        comment: Optional[str] = None
    ) -> Dict:
        """Move project to invested phase."""
        return self.update_status(
            project_id,
            ProjectStatus.ACTIVE,
            ProjectPhase.INVESTED,
            reasons=reasons,
            comment=comment or "Investment completed"
        )
    
    def reject(
        self,
        project_id: str,
        reason: Optional[str] = None
    ) -> Dict:
        """Reject a project."""
        return self.update_status(
            project_id,
            ProjectStatus.DROPPED,
            ProjectPhase.REJECTED,
            comment=reason or "Opportunity rejected"
        )
    
    def archive(
        self,
        project_id: str,
        comment: Optional[str] = None
    ) -> Dict:
        """Archive a project."""
        return self.update_status(
            project_id,
            ProjectStatus.ARCHIVED,
            ProjectPhase.EXITED,
            comment=comment or "Project archived"
        )
    
    def get_available_statuses(self) -> List[str]:
        """Get list of available status codes."""
        config = self.fetch_config()
        return [s['code'] for s in config.get('projectstatus', [])]
    
    def get_available_phases(self) -> List[str]:
        """Get list of available phase codes."""
        config = self.fetch_config()
        return [p['code'] for p in config.get('projectphases', [])]
 
# Usage examples
manager = ProjectStatusManager()
 
# Move to screening
manager.move_to_screening("proj_123", "Initial review scheduled")
 
# Move to due diligence
reasons = [
    {"id": "reason_1", "name": "Strong team"},
    {"id": "reason_2", "name": "Large TAM"}
]
 
manager.move_to_due_diligence(
    "proj_123",
    reasons=reasons,
    comment="Approved for deep dive by partners"
)
 
# Move to invested
manager.move_to_invested(
    "proj_123",
    reasons=reasons,
    comment="Board approved $5M Series A investment"
)
 
# Reject
manager.reject("proj_123", "Market timing concerns")
 
# Archive
manager.archive("proj_123", "Acquired by competitor")
 
# Get available options
statuses = manager.get_available_statuses()
phases = manager.get_available_phases()
 
print(f"Available statuses: {statuses}")
print(f"Available phases: {phases}")

Result: Production-ready manager with enums and helper methods.

cURL

Basic

CODE

curl -X POST "https://api.kruncher.ai/api/integration/project/status" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "521a93a6-091d-4943-ba13-7c1a654a14ae",
    "projectstatusId": "status_active_id",
    "projectphaseId": "phase_invested_id",
    "comment": "Moving to invested phase"
  }'

With Reasons

CODE

curl -X POST "https://api.kruncher.ai/api/integration/project/status" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": "521a93a6-091d-4943-ba13-7c1a654a14ae",
    "projectstatusId": "status_active_id",
    "projectphaseId": "phase_invested_id",
    "reasonTakenArray": [
      {"id": "reason_1", "name": "Strong team"},
      {"id": "reason_2", "name": "Large market"}
    ],
    "comment": "Board approved $5M Series A investment"
  }'

Get Config

CODE

# Get config to find status/phase IDs
curl -s -X GET "https://api.kruncher.ai/api/config" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  | jq '.projectstatus[] | {code: .code, id: .id}'
 
# Get phase IDs
curl -s -X GET "https://api.kruncher.ai/api/config" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  | jq '.projectphases[] | {code: .code, id: .id}'
 
# Find specific status ID
STATUS_ID=$(curl -s -X GET "https://api.kruncher.ai/api/config" \
  -H "Authorization: YOUR_API_KEY_HERE" \
  | jq -r '.projectstatus[] | select(.code == "active") | .id')
 
echo "Active status ID: $STATUS_ID"

Response

Success Response (200 OK)

CODE

{
  "code": "1000",
  "title": "Success",
  "description": "Project status updated successfully",
  "data": {
    "projectId": "521a93a6-091d-4943-ba13-7c1a654a14ae",
    "previousStatus": "screening",
    "newStatus": "active",
    "previousPhase": "undecided",
    "newPhase": "invested",
    "comment": "Board approved $5M Series A investment",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
}

Error Responses

400 Bad Request

CODE

{
  "code": "4000",
  "title": "Bad Request",
  "description": "Invalid status ID or phase ID"
}

404 Not Found

CODE

{
  "code": "4040",
  "title": "Not Found",
  "description": "Project not found"
}

Pipeline Workflow Examples

Example 1: Complete Investment Flow

CODE

const manager = new ProjectStatusManager(API_KEY);
 
// Step 1: Initial screening
await manager.moveToScreening("proj_123");
 
// Step 2: Passed screening, move to due diligence
const ddReasons = [
  { id: "reason_1", name: "Strong founding team" },
  { id: "reason_2", name: "Large TAM" },
  { id: "reason_3", name: "Innovative product" }
];
 
await manager.moveToDueDiligence(
  "proj_123",
  ddReasons,
  "Approved by investment committee"
);
 
// Step 3: Due diligence complete, move to investment
const investmentReasons = [
  { id: "reason_1", name: "Excellent financials" },
  { id: "reason_2", name: "Strong market validation" }
];
 
await manager.moveToInvested(
  "proj_123",
  investmentReasons,
  "Board approved $5M Series A lead"
);
 
console.log("Investment complete!");

Example 2: Rejection Flow

CODE

manager = ProjectStatusManager()
 
# Company doesn't fit investment criteria
manager.reject(
    "proj_456",
    "Market timing concerns - space too competitive"
)
 
# Later: Archive the rejected project
manager.archive(
    "proj_456",
    "Archived rejected opportunities for Q1 2024"
)

Example 3: Bulk Status Updates

CODE

const manager = new ProjectStatusManager(API_KEY);
 
const projectsToMove = [
  { id: "proj_1", status: "screening", phase: "undecided" },
  { id: "proj_2", status: "active", phase: "duediligence" },
  { id: "proj_3", status: "dropped", phase: "rejected" }
];
 
for (const project of projectsToMove) {
  try {
    await manager.updateStatus(
      project.id,
      project.status,
      project.phase,
      [],
      `Bulk update to ${project.status}`
    );
    console.log(`✓ Updated ${project.id}`);
  } catch (error) {
    console.error(`✗ Failed to update ${project.id}: ${error.message}`);
  }
}

Webhook Integration

When a status change is made, a changedStatus webhook event is triggered if webhooks are configured.

Webhook Payload

CODE

{
  "eventType": "changedStatus",
  "projectId": "521a93a6-091d-4943-ba13-7c1a654a14ae",
  "previousStatus": "screening",
  "newStatus": "active",
  "previousPhase": "undecided",
  "newPhase": "invested",
  "comment": "Board approved investment",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Configure webhooks in your Webhook Settings to receive these notifications.

Best Practices

Before Updating Status

Verify project exists
Check current status to avoid redundant updates
Validate status/phase transitions (e.g., can’t go from invested to undecided)
Log all status changes
Add meaningful comments for audit trail

Using Reasons

Always provide reasons when moving to due diligence or investment
Use consistent reason codes across team
Document reason IDs in team documentation
Track which reasons drive decisions

Comments

Keep under 1000 characters
Be specific about decision drivers
Include dollar amounts for investments
Reference meeting/committee that made decision
Use consistent format for searchability

Error Handling

CODE

try {
  await manager.moveToInvested("proj_123", reasons, comment);
} catch (error) {
  if (error.message.includes("Invalid")) {
    // Invalid status or phase
    console.error("Check status/phase codes");
  } else if (error.message.includes("not found")) {
    // Project doesn't exist
    console.error("Project not found");
  } else {
    // Other error
    console.error("Update failed:", error);
  }
}

Configuration - Get valid status and phase IDs
Find Companies - Get project IDs
Webhooks - Configure status change notifications
Update Analysis - Update project data

Troubleshooting

Invalid Status ID

Call /api/config to get current valid IDs
Check for typos in status code
Verify status exists in your account

Invalid Phase ID

Call /api/config to get current valid IDs
Phase codes are case-sensitive
Verify phase exists for your account

Project Not Found

Verify project ID is correct
Check project hasn’t been deleted
Ensure you have access to project

Status Transition Blocked

Some transitions may be restricted by business rules
Contact support if expected transition is blocked
Review pipeline configuration

Need Help?

Custom statuses? Contact support to configure
Webhook issues? Check Webhook Guide
Bulk updates? Ask about batch processing
Audit trail? All changes logged with comments

Change Status

Endpoint

Headers

Request Body

Getting Required IDs

Common Status Codes

Common Phase Codes

Code Examples

JavaScript/TypeScript

Basic

With Reasons

Advanced

Python

Basic

With Reasons

Advanced

cURL

Basic

With Reasons

Get Config

Response

Success Response (200 OK)

Error Responses

400 Bad Request

404 Not Found

Pipeline Workflow Examples

Example 1: Complete Investment Flow

Example 2: Rejection Flow

Example 3: Bulk Status Updates

Webhook Integration

Webhook Payload

Best Practices

Before Updating Status

Using Reasons

Comments

Error Handling

Related Endpoints

Troubleshooting

Invalid Status ID

Invalid Phase ID

Project Not Found

Status Transition Blocked

Need Help?