Product operations system: customer support issues escalated to product (SUP-*), product escalations that need a product plan (PE-*), and the product roadmap with releases and publish readiness (REL-*). Resembles the in-house product-ops tooling product teams build on top of their tracker and wiki. Start with list_support_issues, list_product_escalations or search_roadmap_items to find a record's id, then the matching get_* tool. Writes change this instance only; Slack notices are recorded, never sent.
---
**Acting as a user (`X-PS-Impersonate-User`).** Every endpoint accepts an optional `X-PS-Impersonate-User` request header whose value is the email of the instance user to act as. The effective user resolves in this order: the header if present, else the instance's configured default MCP user, else none. User-scoped paths additionally accept the literal `me` in place of an email, and Graph-style apps also serve `/me/…` twins of their `/users/{email}/…` paths that resolve the same way. This header is honored by all operations but is intentionally omitted from each operation's parameter list so it is not surfaced as a per-tool argument by MCP clients; see the `ImpersonateUser` entry under `components.parameters`.
Product operations system: customer support issues escalated to product (SUP-*), product escalations that need a product plan (PE-*), and the product roadmap with releases and publish readiness (REL-*). Resembles the in-house product-ops tooling product teams build on top of their tracker and wiki. Start with list_support_issues, list_product_escalations or search_roadmap_items to find a record's id, then the matching get_* tool. Writes change this instance only; Slack notices are recorded, never sent.
---
**Acting as a user (`X-PS-Impersonate-User`).** Every endpoint accepts an optional `X-PS-Impersonate-User` request header whose value is the email of the instance user to act as. The effective user resolves in this order: the header if present, else the instance's configured default MCP user, else none. User-scoped paths additionally accept the literal `me` in place of an email, and Graph-style apps also serve `/me/…` twins of their `/users/{email}/…` paths that resolve the same way. This header is honored by all operations but is intentionally omitted from each operation's parameter list so it is not surfaced as a per-tool argument by MCP clients; see the `ImpersonateUser` entry under `components.parameters`.
Operations
GET /support-issues
List support issues
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "List support issues",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer",
"default": 50
},
"description": "Legacy page size (default 50). Prefer $top. Ignored when $top/$skip are used."
},
{
"in": "query",
"name": "cursor",
"schema": {
"type": "string"
},
"description": "Legacy keyset cursor — pass the previous response's nextCursor. Prefer $skip/$top."
},
{
"in": "query",
"name": "$filter",
"schema": {
"type": "string"
},
"description": "OData filter expression. Comparison operators: eq, ne, gt, ge, lt, le. Logical: and, or, not, with parentheses for grouping. String functions: contains(field,'x'), startswith(field,'x'), endswith(field,'x'). Membership: field in ('a','b'). Case-insensitive matching via tolower(field) / toupper(field). Nested fields use a slash, e.g. pto_balance/vacation_days. String literals use single quotes; dates are ISO-8601. Examples: \"status eq 'active'\"; \"salary gt 50000 and department eq 'Engineering'\"; \"contains(tolower(name),'acme')\"; \"closeDate gt 2026-01-01\"."
},
{
"in": "query",
"name": "$select",
"schema": {
"type": "string"
},
"description": "Comma-separated list of fields to return, e.g. \"id,firstName,email\". Nested fields via slash (\"pto_balance/vacation_days\"). The id field is always included."
},
{
"in": "query",
"name": "$orderby",
"schema": {
"type": "string"
},
"description": "Sort clause(s), comma-separated, each \"field [asc|desc]\" (asc is the default). Example: \"createdAt desc, lastName asc\". Null values sort last."
},
{
"in": "query",
"name": "$search",
"schema": {
"type": "string"
},
"description": "Free-text, case-insensitive substring match across the resource's searchable fields."
},
{
"in": "query",
"name": "$top",
"schema": {
"type": "integer"
},
"description": "Maximum number of items to return (page size)."
},
{
"in": "query",
"name": "$skip",
"schema": {
"type": "integer"
},
"description": "Number of matching items to skip before returning results (offset paging). Combine with $top."
},
{
"in": "query",
"name": "$count",
"schema": {
"type": "boolean"
},
"description": "When true, include @odata.count (total matches after $filter/$search, before paging) in the response."
}
],
"responses": {
"200": {
"description": "Paginated list",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SupportIssue"
}
},
"nextCursor": {
"type": "string",
"nullable": true,
"description": "Cursor for the next page, or null on the last page. With $top/$skip this is the next $skip value; otherwise a keyset cursor."
},
"total": {
"type": "integer",
"description": "Total documents in the collection."
},
"@odata.count": {
"type": "integer",
"description": "Present only when $count=true: total matches after $filter/$search."
},
"@odata.truncated": {
"type": "boolean",
"description": "Present and true only when the collection exceeded the in-memory query cap and results may be incomplete."
}
}
}
}
}
},
"400": {
"description": "Invalid OData query (e.g. malformed $filter)"
}
},
"x-mcp": false
}
GET /support-issues/{id}
Get support issue
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "Get support issue",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SupportIssue"
}
}
}
},
"404": {
"description": "Not found"
}
},
"x-mcp": false
}
GET /escalations
List product escalations
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "List product escalations",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer",
"default": 50
},
"description": "Legacy page size (default 50). Prefer $top. Ignored when $top/$skip are used."
},
{
"in": "query",
"name": "cursor",
"schema": {
"type": "string"
},
"description": "Legacy keyset cursor — pass the previous response's nextCursor. Prefer $skip/$top."
},
{
"in": "query",
"name": "$filter",
"schema": {
"type": "string"
},
"description": "OData filter expression. Comparison operators: eq, ne, gt, ge, lt, le. Logical: and, or, not, with parentheses for grouping. String functions: contains(field,'x'), startswith(field,'x'), endswith(field,'x'). Membership: field in ('a','b'). Case-insensitive matching via tolower(field) / toupper(field). Nested fields use a slash, e.g. pto_balance/vacation_days. String literals use single quotes; dates are ISO-8601. Examples: \"status eq 'active'\"; \"salary gt 50000 and department eq 'Engineering'\"; \"contains(tolower(name),'acme')\"; \"closeDate gt 2026-01-01\"."
},
{
"in": "query",
"name": "$select",
"schema": {
"type": "string"
},
"description": "Comma-separated list of fields to return, e.g. \"id,firstName,email\". Nested fields via slash (\"pto_balance/vacation_days\"). The id field is always included."
},
{
"in": "query",
"name": "$orderby",
"schema": {
"type": "string"
},
"description": "Sort clause(s), comma-separated, each \"field [asc|desc]\" (asc is the default). Example: \"createdAt desc, lastName asc\". Null values sort last."
},
{
"in": "query",
"name": "$search",
"schema": {
"type": "string"
},
"description": "Free-text, case-insensitive substring match across the resource's searchable fields."
},
{
"in": "query",
"name": "$top",
"schema": {
"type": "integer"
},
"description": "Maximum number of items to return (page size)."
},
{
"in": "query",
"name": "$skip",
"schema": {
"type": "integer"
},
"description": "Number of matching items to skip before returning results (offset paging). Combine with $top."
},
{
"in": "query",
"name": "$count",
"schema": {
"type": "boolean"
},
"description": "When true, include @odata.count (total matches after $filter/$search, before paging) in the response."
}
],
"responses": {
"200": {
"description": "Paginated list",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ProductEscalation"
}
},
"nextCursor": {
"type": "string",
"nullable": true,
"description": "Cursor for the next page, or null on the last page. With $top/$skip this is the next $skip value; otherwise a keyset cursor."
},
"total": {
"type": "integer",
"description": "Total documents in the collection."
},
"@odata.count": {
"type": "integer",
"description": "Present only when $count=true: total matches after $filter/$search."
},
"@odata.truncated": {
"type": "boolean",
"description": "Present and true only when the collection exceeded the in-memory query cap and results may be incomplete."
}
}
}
}
}
},
"400": {
"description": "Invalid OData query (e.g. malformed $filter)"
}
},
"x-mcp": false
}
GET /escalations/{id}
Get product escalation
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "Get product escalation",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProductEscalation"
}
}
}
},
"404": {
"description": "Not found"
}
},
"x-mcp": false
}
GET /roadmap-items
List roadmap items
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "List roadmap items",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer",
"default": 50
},
"description": "Legacy page size (default 50). Prefer $top. Ignored when $top/$skip are used."
},
{
"in": "query",
"name": "cursor",
"schema": {
"type": "string"
},
"description": "Legacy keyset cursor — pass the previous response's nextCursor. Prefer $skip/$top."
},
{
"in": "query",
"name": "$filter",
"schema": {
"type": "string"
},
"description": "OData filter expression. Comparison operators: eq, ne, gt, ge, lt, le. Logical: and, or, not, with parentheses for grouping. String functions: contains(field,'x'), startswith(field,'x'), endswith(field,'x'). Membership: field in ('a','b'). Case-insensitive matching via tolower(field) / toupper(field). Nested fields use a slash, e.g. pto_balance/vacation_days. String literals use single quotes; dates are ISO-8601. Examples: \"status eq 'active'\"; \"salary gt 50000 and department eq 'Engineering'\"; \"contains(tolower(name),'acme')\"; \"closeDate gt 2026-01-01\"."
},
{
"in": "query",
"name": "$select",
"schema": {
"type": "string"
},
"description": "Comma-separated list of fields to return, e.g. \"id,firstName,email\". Nested fields via slash (\"pto_balance/vacation_days\"). The id field is always included."
},
{
"in": "query",
"name": "$orderby",
"schema": {
"type": "string"
},
"description": "Sort clause(s), comma-separated, each \"field [asc|desc]\" (asc is the default). Example: \"createdAt desc, lastName asc\". Null values sort last."
},
{
"in": "query",
"name": "$search",
"schema": {
"type": "string"
},
"description": "Free-text, case-insensitive substring match across the resource's searchable fields."
},
{
"in": "query",
"name": "$top",
"schema": {
"type": "integer"
},
"description": "Maximum number of items to return (page size)."
},
{
"in": "query",
"name": "$skip",
"schema": {
"type": "integer"
},
"description": "Number of matching items to skip before returning results (offset paging). Combine with $top."
},
{
"in": "query",
"name": "$count",
"schema": {
"type": "boolean"
},
"description": "When true, include @odata.count (total matches after $filter/$search, before paging) in the response."
}
],
"responses": {
"200": {
"description": "Paginated list",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/RoadmapItem"
}
},
"nextCursor": {
"type": "string",
"nullable": true,
"description": "Cursor for the next page, or null on the last page. With $top/$skip this is the next $skip value; otherwise a keyset cursor."
},
"total": {
"type": "integer",
"description": "Total documents in the collection."
},
"@odata.count": {
"type": "integer",
"description": "Present only when $count=true: total matches after $filter/$search."
},
"@odata.truncated": {
"type": "boolean",
"description": "Present and true only when the collection exceeded the in-memory query cap and results may be incomplete."
}
}
}
}
}
},
"400": {
"description": "Invalid OData query (e.g. malformed $filter)"
}
},
"x-mcp": false
}
GET /roadmap-items/{id}
Get roadmap item
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "Get roadmap item",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RoadmapItem"
}
}
}
},
"404": {
"description": "Not found"
}
},
"x-mcp": false
}
GET /accounts
List customer accounts
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "List customer accounts",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer",
"default": 50
},
"description": "Legacy page size (default 50). Prefer $top. Ignored when $top/$skip are used."
},
{
"in": "query",
"name": "cursor",
"schema": {
"type": "string"
},
"description": "Legacy keyset cursor — pass the previous response's nextCursor. Prefer $skip/$top."
},
{
"in": "query",
"name": "$filter",
"schema": {
"type": "string"
},
"description": "OData filter expression. Comparison operators: eq, ne, gt, ge, lt, le. Logical: and, or, not, with parentheses for grouping. String functions: contains(field,'x'), startswith(field,'x'), endswith(field,'x'). Membership: field in ('a','b'). Case-insensitive matching via tolower(field) / toupper(field). Nested fields use a slash, e.g. pto_balance/vacation_days. String literals use single quotes; dates are ISO-8601. Examples: \"status eq 'active'\"; \"salary gt 50000 and department eq 'Engineering'\"; \"contains(tolower(name),'acme')\"; \"closeDate gt 2026-01-01\"."
},
{
"in": "query",
"name": "$select",
"schema": {
"type": "string"
},
"description": "Comma-separated list of fields to return, e.g. \"id,firstName,email\". Nested fields via slash (\"pto_balance/vacation_days\"). The id field is always included."
},
{
"in": "query",
"name": "$orderby",
"schema": {
"type": "string"
},
"description": "Sort clause(s), comma-separated, each \"field [asc|desc]\" (asc is the default). Example: \"createdAt desc, lastName asc\". Null values sort last."
},
{
"in": "query",
"name": "$search",
"schema": {
"type": "string"
},
"description": "Free-text, case-insensitive substring match across the resource's searchable fields."
},
{
"in": "query",
"name": "$top",
"schema": {
"type": "integer"
},
"description": "Maximum number of items to return (page size)."
},
{
"in": "query",
"name": "$skip",
"schema": {
"type": "integer"
},
"description": "Number of matching items to skip before returning results (offset paging). Combine with $top."
},
{
"in": "query",
"name": "$count",
"schema": {
"type": "boolean"
},
"description": "When true, include @odata.count (total matches after $filter/$search, before paging) in the response."
}
],
"responses": {
"200": {
"description": "Paginated list",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Account"
}
},
"nextCursor": {
"type": "string",
"nullable": true,
"description": "Cursor for the next page, or null on the last page. With $top/$skip this is the next $skip value; otherwise a keyset cursor."
},
"total": {
"type": "integer",
"description": "Total documents in the collection."
},
"@odata.count": {
"type": "integer",
"description": "Present only when $count=true: total matches after $filter/$search."
},
"@odata.truncated": {
"type": "boolean",
"description": "Present and true only when the collection exceeded the in-memory query cap and results may be incomplete."
}
}
}
}
}
},
"400": {
"description": "Invalid OData query (e.g. malformed $filter)"
}
},
"x-mcp": false
}
GET /accounts/{id}
Get customer account
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"summary": "Get customer account",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Account"
}
}
}
},
"404": {
"description": "Not found"
}
},
"x-mcp": false
}
GET /lookup/support-issues
List active support issues
Slim summaries of non-closed support issues, narrowed by any filter. Backs the list_support_issues tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "List active support issues",
"description": "Slim summaries of non-closed support issues, narrowed by any filter. Backs the list_support_issues tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "account",
"schema": {
"type": "string"
},
"description": "Account name, case-insensitive substring."
},
{
"in": "query",
"name": "case_owner_email",
"schema": {
"type": "string"
},
"description": "Case owner email, or 'me'."
},
{
"in": "query",
"name": "created_after",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "created_before",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "days_in_status_over",
"schema": {
"type": "integer"
},
"description": "More than this many business days in the current status."
},
{
"in": "query",
"name": "eng_manager_email",
"schema": {
"type": "string"
},
"description": "Engineering manager email, or 'me'."
},
{
"in": "query",
"name": "in_violation",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "missing_intake_requirements",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "missing_troubleshooting",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "missing_urgency_justification",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "no_commit_date",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "no_scoping_date",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "pm_email",
"schema": {
"type": "string"
},
"description": "Assignment group PM email, or 'me'."
},
{
"in": "query",
"name": "product_area",
"schema": {
"type": "string"
},
"description": "Exact product area."
},
{
"in": "query",
"name": "resolved_after",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "resolved_before",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "source",
"schema": {
"type": "string"
},
"description": "Customer, BU, DT or Presales."
},
{
"in": "query",
"name": "status",
"schema": {
"type": "string"
},
"description": "Exact support status, e.g. PM Review."
},
{
"in": "query",
"name": "urgency_level",
"schema": {
"type": "string"
},
"description": "low, medium or high."
},
{
"in": "query",
"name": "user_email",
"schema": {
"type": "string"
},
"description": "Assigned in any role, or 'me'."
}
],
"responses": {
"200": {
"description": "List active support issues",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/support-issues/{identifier}
Get a support issue
The full support issue by prefix id or page id. Backs the get_support_issue tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Get a support issue",
"description": "The full support issue by prefix id or page id. Backs the get_support_issue tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "Get a support issue",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/support-issues/{identifier}/violations
List a support issue's SLA violations
Recorded SLA violations for one support issue. Backs the get_support_violations tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "List a support issue's SLA violations",
"description": "Recorded SLA violations for one support issue. Backs the get_support_violations tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "List a support issue's SLA violations",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
POST /actions/support-issues/{identifier}/resolve
Resolve a support issue
Sets the resolution type and readback and moves the issue to Resolved. Backs the move_support_issue_to_resolved tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"summary": "Resolve a support issue",
"description": "Sets the resolution type and readback and moves the issue to Resolved. Backs the move_support_issue_to_resolved tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"resolution_type": {
"type": "string",
"enum": [
"Misfiled",
"Temporary Issue",
"Working as Expected",
"Patched w/ Internal Tools",
"Known ML Performance Gap",
"Bug Fix Applied",
"Created Known Bug",
"Escalated to Outage/P0"
]
},
"resolution_readback": {
"type": "string"
}
},
"required": [
"resolution_type",
"resolution_readback"
]
}
}
}
},
"responses": {
"200": {
"description": "Resolved",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
},
"409": {
"description": "The issue is Closed"
}
}
}
GET /lookup/escalations
List active product escalations
Slim summaries of non-closed product escalations, narrowed by any filter. Backs the list_product_escalations tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "List active product escalations",
"description": "Slim summaries of non-closed product escalations, narrowed by any filter. Backs the list_product_escalations tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "account",
"schema": {
"type": "string"
},
"description": "Account name, case-insensitive substring."
},
{
"in": "query",
"name": "check_in_within_days",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "commit_within_days",
"schema": {
"type": "integer"
}
},
{
"in": "query",
"name": "created_after",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "created_before",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "dri_email",
"schema": {
"type": "string"
},
"description": "Product DRI email, or 'me'."
},
{
"in": "query",
"name": "in_violation",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "no_commit_date",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "no_dri",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "no_sfdc_opportunity",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "overdue",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "product_area",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "resolved_after",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "resolved_before",
"schema": {
"type": "string"
},
"description": "YYYY-MM-DD"
},
{
"in": "query",
"name": "sponsor_email",
"schema": {
"type": "string"
},
"description": "Product sponsor email, or 'me'."
},
{
"in": "query",
"name": "status",
"schema": {
"type": "string"
},
"description": "Exact PE stage, e.g. Plan Development."
},
{
"in": "query",
"name": "user_email",
"schema": {
"type": "string"
},
"description": "Assigned in any role, or 'me'."
}
],
"responses": {
"200": {
"description": "List active product escalations",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/escalations/{identifier}
Get a product escalation
The full product escalation by prefix id or page id. Backs the get_product_escalation tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Get a product escalation",
"description": "The full product escalation by prefix id or page id. Backs the get_product_escalation tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "Get a product escalation",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/escalations/{identifier}/violations
List a product escalation's violations
Recorded violations for one product escalation. Backs the get_pe_violations tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "List a product escalation's violations",
"description": "Recorded violations for one product escalation. Backs the get_pe_violations tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "List a product escalation's violations",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
POST /actions/escalations/update
Preview or post a product escalation update
execute=false previews the changes and returns a confirmation; execute=true with that confirmation_token applies them. Backs the post_product_escalation_update tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"summary": "Preview or post a product escalation update",
"description": "execute=false previews the changes and returns a confirmation; execute=true with that confirmation_token applies them. Backs the post_product_escalation_update tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"execute": {
"type": "boolean"
},
"confirmation_token": {
"type": "string"
},
"stage": {
"type": "string",
"enum": [
"Holding",
"Account Team Validation",
"Product Leadership Triage",
"Plan Development",
"Resolution Plan Readback",
"Resolution In progress",
"Resolved",
"Closed"
]
},
"committed_date": {
"type": "string"
},
"next_check_in_date": {
"type": "string"
},
"product_dri_email": {
"type": "string"
},
"resolution_approach": {
"type": "string"
},
"next_steps_entry": {
"type": "string"
},
"notion_comment": {
"type": "string"
},
"slack_message": {
"type": "string"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Preview or result",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/roadmap-search
Search roadmap items
Ranked roadmap items by title words. Backs the search_roadmap_items tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Search roadmap items",
"description": "Ranked roadmap items by title words. Backs the search_roadmap_items tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "query",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "include_unpublished",
"schema": {
"type": "boolean"
}
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "Search roadmap items",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/roadmap-items/{identifier}
Get a roadmap item
One roadmap item by REL id, project id, URL or name; several name matches return status ambiguous. Backs the get_roadmap_item tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Get a roadmap item",
"description": "One roadmap item by REL id, project id, URL or name; several name matches return status ambiguous. Backs the get_roadmap_item tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "Get a roadmap item",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/roadmap-releases
Current roadmap releases
Every published roadmap item with its release dates, as of now. Backs the get_roadmap_releases tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Current roadmap releases",
"description": "Every published roadmap item with its release dates, as of now. Backs the get_roadmap_releases tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
}
],
"responses": {
"200": {
"description": "Current roadmap releases",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/roadmap-product-areas
Roadmap product areas
The product area labels in use. Backs the get_roadmap_product_areas tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Roadmap product areas",
"description": "The product area labels in use. Backs the get_roadmap_product_areas tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
}
],
"responses": {
"200": {
"description": "Roadmap product areas",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
POST /lookup/roadmap-readiness
Check roadmap item readiness
Blockers and missing template slots for publishing or updating an item; writes nothing. Backs the check_roadmap_readiness tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"summary": "Check roadmap item readiness",
"description": "Blockers and missing template slots for publishing or updating an item; writes nothing. Backs the check_roadmap_readiness tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"operation": {
"type": "string",
"enum": [
"publish",
"update"
]
},
"proposed": {
"type": "object"
}
},
"required": [
"identifier",
"operation"
]
}
}
}
},
"responses": {
"200": {
"description": "Readiness",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
POST /actions/roadmap-items/update
Preview or apply a roadmap item edit
execute=false returns field_changes and a confirmation_token; execute=true with the token applies them. Backs the update_roadmap_item tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"summary": "Preview or apply a roadmap item edit",
"description": "execute=false returns field_changes and a confirmation_token; execute=true with the token applies them. Backs the update_roadmap_item tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"identifier": {
"type": "string"
},
"execute": {
"type": "boolean"
},
"confirmation_token": {
"type": "string"
},
"title": {
"type": "string"
},
"short_description": {
"type": "string"
},
"writeup": {
"type": "string"
},
"release_type": {
"type": "string",
"enum": [
"New Capability",
"Deprecation",
"Migration",
"Assistant Behavior Change"
]
},
"publish_visibility": {
"type": "string",
"enum": [
"external",
"internal"
]
},
"lead_email": {
"type": "string"
},
"opm_email": {
"type": "string"
},
"ca_program": {
"type": "string"
},
"public_release": {
"type": "object"
},
"limited_preview": {
"type": "object"
},
"servicenow_internal_release_date": {
"type": "object"
},
"template_content": {
"type": "object"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Preview or result",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/accounts
Find accounts
Typo-tolerant account name search with a confident flag. Backs the find_account tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Find accounts",
"description": "Typo-tolerant account name search with a confident flag. Backs the find_account tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "query",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "Find accounts",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/accounts/{identifier}
Get an account
One account by SFDC id, page id, record id or exact name. Backs the get_account tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Get an account",
"description": "One account by SFDC id, page id, record id or exact name. Backs the get_account tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "path",
"name": "identifier",
"required": true,
"schema": {
"type": "string"
},
"description": "Prefix id (SUP-1001, PE-1001, REL-1001), page id, or name."
}
],
"responses": {
"200": {
"description": "Get an account",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/users
Resolve a person
A person's canonical email from 'me', an email or a name. Backs the resolve_user tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "Resolve a person",
"description": "A person's canonical email from 'me', an email or a name. Backs the resolve_user tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "query",
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"schema": {
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "Resolve a person",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}
GET /lookup/sla-definitions
SLA rules
Every condition that puts a support issue (se) or product escalation (pe) in violation. Backs the get_sla_definitions tool.
Authentication
[
{
"patAuth": []
}
]
Request, responses and operation details
{
"x-mcp": false,
"x-odata": false,
"summary": "SLA rules",
"description": "Every condition that puts a support issue (se) or product escalation (pe) in violation. Backs the get_sla_definitions tool.",
"parameters": [
{
"$ref": "#/components/parameters/InstanceId"
},
{
"in": "query",
"name": "domain",
"schema": {
"type": "string"
},
"description": "all, se or pe"
}
],
"responses": {
"200": {
"description": "SLA rules",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"404": {
"description": "No record matches the identifier"
}
}
}