​

Issues, RFIs, and Punch API

​

Issues

• GET /projects/:projectId/issues
• POST /projects/:projectId/issues
• PATCH /projects/:projectId/issues/:issueId
• DELETE /projects/:projectId/issues/:issueId

​

RFIs

• GET /projects/:projectId/rfi
• POST /projects/:projectId/rfi
• GET /projects/:projectId/rfi/:rfiId
• PATCH /projects/:projectId/rfi/:rfiId
• POST /projects/:projectId/rfi/:rfiId/messages
• POST /projects/:projectId/rfi/:rfiId/attachments/presign
• POST /projects/:projectId/rfi/:rfiId/attachments/complete

​

Punch lists

• GET /projects/:projectId/punch
• POST /projects/:projectId/punch
• PATCH /projects/:projectId/punch/:punchId
• DELETE /projects/:projectId/punch/:punchId

​

Field reports

• GET /projects/:projectId/field-reports
• POST /projects/:projectId/field-reports
• PATCH /projects/:projectId/field-reports/:reportId
• DELETE /projects/:projectId/field-reports/:reportId
• POST /projects/:projectId/field-reports/send-email

​

Integration tips

• Sync IDs from your source system to PlanSync IDs in your own integration table
• Treat linked drawing/file version references as authoritative context
• Handle 402 responses where plan-gated modules are not active

​

Example: create issue

curl -X POST "https://api.plansync.dev/api/v1/projects/proj_abc123/issues" \
  -H "Content-Type: application/json" \
  -H "x-api-key: psk_<your-key>" \
  -d '{
    "title": "Water leak near AHU-02",
    "description": "Observed at ceiling tile line C4.",
    "priority": "HIGH",
    "status": "OPEN",
    "issueKind": "WORK_ORDER"
  }'

{
  "id": "iss_abc123",
  "projectId": "proj_abc123",
  "title": "Water leak near AHU-02",
  "status": "OPEN",
  "priority": "HIGH",
  "issueKind": "WORK_ORDER"
}