support

Support

Report a problem or suggest a feature to the vendor from a self-hosted install, and see the vendor's status and replies (self-hosted installs only).

5 נקודות קצה

GET `/api/v1/support/submissions`

What this institute sent the vendor, newest first (cursor-paginated): the text, whether it has left the install, what the vendor did with it and the vendor’s replies. Self-hosted only.

דורש אימותהרשאהsupport.submit

פרמטרים של הנתיב והשאילתה

שם	מיקום	סוג	מגבלות
cursor	query	string	—
limit	query	integer	1–100 · default: 25

דוגמה עם curl

curl

curl -X GET "https://your-institute.example/api/v1/support/submissions" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY"

תשובות

200A page of submissions.

שם	סוג	מגבלות
dataחובה	array<object>	—
nextCursorחובה	string \| null	—

json

{
  "data": [
    {
      "id": "37386ae0-3738-7738-8386-37386ae03738",
      "kind": "problem",
      "category": "login_access",
      "title": "Midterm Exam",
      "body": "string",
      "delivery": "queued",
      "lastError": "string",
      "remoteStatus": "new",
      "createdAt": "2026-03-02T09:00:00.000Z",
      "sentAt": "2026-03-02T09:00:00.000Z",
      "syncedAt": "2026-03-02T09:00:00.000Z",
      "replies": [
        {
          "id": "37386ae0-3738-7738-8386-37386ae03738",
          "body": "string",
          "createdAt": "2026-03-02T09:00:00.000Z"
        }
      ]
    }
  ],
  "nextCursor": null
}

400The request could not be read at all — unparseable body, unusable content type, oversized payload (`MALFORMED_REQUEST`). Never a schema failure: those are 422.

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

401Missing, expired or invalid credentials (`UNAUTHORIZED`, `TOKEN_INVALID`, `SESSION_REVOKED`).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

402The tenant’s subscription or license is locked (`PAYMENT_REQUIRED`, `SUBSCRIPTION_SUSPENDED`).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

403Authenticated, but not allowed (`FORBIDDEN`, `FEATURE_DISABLED`, `QUOTA_EXCEEDED`, …).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

404No such resource, or it is not visible to this tenant (`NOT_FOUND`).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

409Conflicts with current state (`CONFLICT`, `VERSION_CONFLICT`, `IDEMPOTENCY_KEY_REUSED`).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

422The request was read but its content is not acceptable: body/query/path/header failed schema validation (`VALIDATION_ERROR`, with `details.issues`), or a domain rule rejected a well-formed value (`VIDEO_URL_INVALID`, …).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

429Rate limit exceeded — see the `RateLimit-*` and `Retry-After` headers (`RATE_LIMITED`).

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

500Unexpected server error (`INTERNAL_ERROR`). Never carries a stack trace or SQL.

מחזירה את מעטפת השגיאה המשותפת `ErrorEnvelope` — `{ error: { code, message, requestId, details? } }`. כל הקודים מפורטים במדריך המוסכמות.

POST `/api/v1/support/submissions`

Report a problem or suggest a feature to the vendor. Saved here first and sent in the background, retried if the vendor cannot be reached. Do not include personal data. Self-hosted only.

דורש אימותהרשאהsupport.submit

גוף הבקשה

שם	סוג	מגבלות
kindחובה	enum: "problem" \| "feature"	—
categoryחובה	enum: "login_access" \| "people" \| "attendance" \| "billing" \| "courses_content" \| "notifications" \| "updates_backups" \| "performance" \| "other"	—
titleחובה	string	1–120 chars
textחובה	string	1–4000 chars

דוגמה

json

{
  "kind": "problem",
  "category": "login_access",
  "title": "Midterm Exam",
  "text": "string"
}

דוגמה עם curl

curl

curl -X POST "https://your-institute.example/api/v1/support/submissions" \
  -H "Authorization: Bearer $INSTITFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "kind": "problem",
    "category": "login_access",
    "title": "Midterm Exam",
    "text": "string"
  }'

תשובות

201The saved submission, queued.

שם	סוג	מגבלות
idחובה	string (uuid)	—
kindחובה	enum: "problem" \| "feature"	—
categoryחובה	enum: "login_access" \| "people" \| "attendance" \| "billing" \| "courses_content" \| "notifications" \| "updates_backups" \| "performance" \| "other"	—
titleחובה	string	—
bodyחובה	string	—
deliveryחובה	enum: "queued" \| "sent" \| "failed"	—
lastErrorחובה	string \| null	—
remoteStatusחובה	enum: "new" \| "acknowledged" \| "in_progress" \| "resolved" \| "declined" \| "duplicate" \| null \| null	—
createdAtחובה	string (date-time)	—
sentAtחובה	string (date-time) \| null	—
syncedAtחובה	string (date-time) \| null	—
repliesחובה	array<object>	—

json

{
  "id": "37386ae0-3738-7738-8386-37386ae03738",
  "kind": "problem",
  "category": "login_access",
  "title": "Midterm Exam",
  "body": "string",
  "delivery": "queued",
  "lastError": "string",
  "remoteStatus": "new",
  "createdAt": "2026-03-02T09:00:00.000Z",
  "sentAt": "2026-03-02T09:00:00.000Z",
  "syncedAt": "2026-03-02T09:00:00.000Z",
  "replies": [
    {
      "id": "37386ae0-3738-7738-8386-37386ae03738",
      "body": "string",
      "createdAt": "2026-03-02T09:00:00.000Z"
    }
  ]
}