{
 "openapi": "3.1.0",
 "info": {
  "title": "Social (CRM)",
  "version": "20261030b",
  "description": "The social service of CRM: 45 operation(s)."
 },
 "servers": [
  {
   "url": "https://{tenant}.tranxact.ai",
   "variables": {
    "tenant": {
     "default": "demo"
    }
   }
  }
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {}
 },
 "security": [
  {
   "bearer": []
  }
 ],
 "paths": {
  "/api/crm/social/signals": {
   "get": {
    "summary": "Signals",
    "operationId": "action_social_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Signals",
    "operationId": "action_social_1_5",
    "description": "Body keys: platform, body*, author_handle, author_name, url, posted_at, rating, product_area, language, account_id",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}": {
   "get": {
    "summary": "Signals",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/ingest": {
   "post": {
    "summary": "Ingest",
    "operationId": "action_social_0_5",
    "description": "Body keys: account_code*, signals*",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/classify": {
   "post": {
    "summary": "Signals classify",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/reread": {
   "post": {
    "summary": "Signals reread",
    "operationId": "action_social_0_7",
    "description": "Body keys: intent*, severity, sentiment, topic, product_area, urgency, is_spam, is_actionable, rationale; intent one of complaint|service_request|product_defect|outage|billing_dispute|delivery_issue|safety_concern|compliance_concern|praise|question|purchase_intent|feature_request|competitor_mention|news|spam|other; severity one of none|low|moderate|high|critical; sentiment one of positive|neutral|negative|mixed; urgency one of routine|soon|urgent|immediate",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/correlate": {
   "post": {
    "summary": "Signals correlate",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/attach": {
   "post": {
    "summary": "Signals attach",
    "operationId": "action_social_0_7",
    "description": "Body keys: module, resource*, record_id, relation, note; relation one of about|author|affected|referenced|similar",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/correlations/{id}/decide": {
   "post": {
    "summary": "Correlations decide",
    "operationId": "action_social_0_7",
    "description": "Body keys: status; status one of confirmed|rejected",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/score": {
   "post": {
    "summary": "Signals score",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/process": {
   "post": {
    "summary": "Signals process",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/assign": {
   "post": {
    "summary": "Signals assign",
    "operationId": "action_social_0_7",
    "description": "Body keys: assigned_to",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/dismiss": {
   "post": {
    "summary": "Signals dismiss",
    "operationId": "action_social_0_7",
    "description": "Body keys: reason*",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents": {
   "get": {
    "summary": "Incidents",
    "operationId": "action_social_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Incidents",
    "operationId": "action_social_1_5",
    "description": "Body keys: title*, description, category, product_area, severity, signal_ids; category one of outage|product_defect|delivery|billing|safety|compliance|pricing|staff|policy|reputation|other; severity one of sev1|sev2|sev3|sev4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}": {
   "get": {
    "summary": "Incidents",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/incident": {
   "post": {
    "summary": "Signals incident",
    "operationId": "action_social_0_7",
    "description": "Body keys: title, description, category, severity; category one of outage|product_defect|delivery|billing|safety|compliance|pricing|staff|policy|reputation|other; severity one of sev1|sev2|sev3|sev4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}/attach": {
   "post": {
    "summary": "Incidents attach",
    "operationId": "action_social_0_7",
    "description": "Body keys: signal_ids",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}/status": {
   "post": {
    "summary": "Incidents status",
    "operationId": "action_social_0_7",
    "description": "Body keys: status*, owner_id; status one of open|investigating|identified|remediating|monitoring|resolved|closed",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}/root-causes": {
   "post": {
    "summary": "Incidents root causes",
    "operationId": "action_social_0_7",
    "description": "Body keys: hypothesis*, category, module, resource, record_id, evidence, corrective_action, preventive_action, confidence; category one of process|product|supply|system|people|policy|communication|external|unknown",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/root-causes/{id}/decide": {
   "post": {
    "summary": "Root causes decide",
    "operationId": "action_social_0_7",
    "description": "Body keys: state, corrective_action, preventive_action; state one of investigating|confirmed|ruled_out",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}/analyze": {
   "post": {
    "summary": "Incidents analyze",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/actions": {
   "get": {
    "summary": "Actions",
    "operationId": "action_social_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Actions",
    "operationId": "action_social_1_5",
    "description": "Body keys: signal_id, incident_id, kind*, title, detail, rationale, expected_effect, priority, owner_id, due_at; kind one of respond|case|work_order|task|escalate|remediate|product_change|process_change|refund|recall|monitor|no_action; priority one of low|medium|high|urgent",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/actions/{id}/approve": {
   "post": {
    "summary": "Actions approve",
    "operationId": "action_social_0_7",
    "description": "Body keys: owner_id",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/actions/{id}/reject": {
   "post": {
    "summary": "Actions reject",
    "operationId": "action_social_0_7",
    "description": "Body keys: reason*",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/actions/{id}/complete": {
   "post": {
    "summary": "Actions complete",
    "operationId": "action_social_0_7",
    "description": "Body keys: note, record_no",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/respond": {
   "post": {
    "summary": "Signals respond",
    "operationId": "action_social_0_7",
    "description": "Body keys: body, action_id, channel, tone; channel one of public_reply|direct_message|review_reply|email|phone|none",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/responses/{id}": {
   "put": {
    "summary": "Responses",
    "operationId": "action_social_0_6",
    "description": "Body keys: body, channel; channel one of public_reply|direct_message|review_reply|email|phone|none",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/responses/{id}/approve": {
   "post": {
    "summary": "Responses approve",
    "operationId": "action_social_0_7",
    "description": "Body keys: body",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/responses/{id}/publish": {
   "post": {
    "summary": "Responses publish",
    "operationId": "action_social_0_7",
    "description": "Body keys: posted_manually, url",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/signals/{id}/measure": {
   "post": {
    "summary": "Signals measure",
    "operationId": "action_social_0_7",
    "description": "Body keys: window_hours, action_id, notes",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/incidents/{id}/measure": {
   "post": {
    "summary": "Incidents measure",
    "operationId": "action_social_0_7",
    "description": "Body keys: window_hours, action_id, notes",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/feedback": {
   "post": {
    "summary": "Feedback",
    "operationId": "action_social_0_5",
    "description": "Body keys: signal_id, target, verdict*, corrected, reason, action_id, correlation_id, outcome_id; target one of classification|risk_score|correlation|action|response|outcome; verdict one of agree|partly|disagree",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/feedback/{id}/apply": {
   "post": {
    "summary": "Feedback apply",
    "operationId": "action_social_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/loop": {
   "get": {
    "summary": "Loop",
    "operationId": "action_social_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/signals": {
   "get": {
    "summary": "Reports signals",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/incidents": {
   "get": {
    "summary": "Reports incidents",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/actions": {
   "get": {
    "summary": "Reports actions",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/outcomes": {
   "get": {
    "summary": "Reports outcomes",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/learning": {
   "get": {
    "summary": "Reports learning",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/reports/loop": {
   "get": {
    "summary": "Reports loop",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/handles": {
   "get": {
    "summary": "Handles",
    "operationId": "action_social_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Handles",
    "operationId": "action_social_1_5",
    "description": "Body keys: platform*, handle, subject_type, subject_id, display_name; subject_type one of account|contact|prospect|student|supplier|employee",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/crm/social/handles/{id}": {
   "delete": {
    "summary": "Handles",
    "operationId": "action_social_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  }
 }
}