{
  "connector": "servicedesk-plus",
  "label": "ServiceDesk Plus",
  "vendor_docs": "https://www.manageengine.com/products/service-desk/sdpod-v3-api/getting-started/api-index.html",
  "summary": "Cloud and on-prem REST v3 ticket investigations, approvals and CMDB over the shared Era estate.",
  "surfaces": [
    {
      "kind": "REST",
      "path": "/api/v3",
      "notes": "On-prem; Cloud also uses /app/{portal}/api/v3"
    },
    {
      "kind": "MCP",
      "path": "/mcp",
      "notes": "API-derived resource and approval tools"
    }
  ],
  "api_versions": [
    "REST v3"
  ],
  "supported": [
    {
      "item": "Requests, changes, problems, notes, worklogs, approvals, technicians and assets"
    },
    {
      "item": "input_data envelopes, list_info pagination, field selection, sorting and search criteria"
    }
  ],
  "unsupported": [
    {
      "item": "Attachments, projects, releases, purchases and notification delivery"
    }
  ],
  "differences": [
    {
      "scenario": "Writes",
      "difference": "REST and MCP writes require a tenant write grant.",
      "guidance": "Enable writes before creating or updating tickets or approvals."
    },
    {
      "scenario": "Schema customization",
      "difference": "Tenant-specific custom CMDB types and workflow rules are not modeled.",
      "guidance": "Use the documented resource collections and returned ids."
    }
  ],
  "faults_supported": [
    {
      "fault": "throttle",
      "behaviour": "Native failure envelope, HTTP 429 and Retry-After."
    },
    {
      "fault": "fail_next",
      "behaviour": "The next N data-plane requests receive HTTP 429."
    },
    {
      "fault": "quota_limit",
      "behaviour": "HTTP 429 after the configured request quota."
    },
    {
      "fault": "error_rate",
      "behaviour": "Native failure envelope with HTTP 500."
    },
    {
      "fault": "latency_ms",
      "behaviour": "Fixed latency on data-plane requests."
    }
  ]
}
