Purple Product Ops API OpenAPI

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`.

This reference is readable without JavaScript. Download the OpenAPI document.

Runtime

/api/purple-suite/product-ops

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`.

Servers

[
  {
    "url": "https://marketplace.moveworks.com/api/purple-suite/product-ops"
  }
]

Authentication schemes

{
  "patAuth": {
    "type": "http",
    "scheme": "bearer"
  }
}

Each operation lists its security requirements. An empty security array permits an unauthenticated request. Use the scheme and headers declared for the selected contract.

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 /comments

List support issue comments

Authentication

[
  {
    "patAuth": []
  }
]

Request, responses and operation details

{
  "summary": "List support issue comments",
  "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/SupportComment"
                }
              },
              "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 /comments/{id}

Get support issue comment

Authentication

[
  {
    "patAuth": []
  }
]

Request, responses and operation details

{
  "summary": "Get support issue comment",
  "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/SupportComment"
          }
        }
      }
    },
    "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}/comments

Comment on a support issue

Adds a comment to the issue. Backs the add_support_issue_comment tool.

Authentication

[
  {
    "patAuth": []
  }
]

Request, responses and operation details

{
  "x-mcp": false,
  "summary": "Comment on a support issue",
  "description": "Adds a comment to the issue. Backs the add_support_issue_comment 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": {
            "comment": {
              "type": "string"
            },
            "mention_user_ids": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "required": [
            "comment"
          ]
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Comment added",
      "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-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"
    }
  }
}

Schemas and reusable components

securitySchemes

patAuth

{
  "type": "http",
  "scheme": "bearer"
}

parameters

InstanceId

{
  "in": "header",
  "name": "X-Instance-ID",
  "required": true,
  "schema": {
    "type": "string"
  }
}

ImpersonateUser

{
  "in": "header",
  "name": "X-PS-Impersonate-User",
  "required": false,
  "schema": {
    "type": "string",
    "format": "email"
  },
  "description": "Optional. Act as a specific user in the target instance — the value is that user's email (must exist in the instance). Resolution order for the effective user: (1) this header, if set; (2) the instance's configured default MCP user; (3) otherwise no user is bound. User-scoped paths (e.g. /users/{email}/…) also accept the literal \"me\", and Graph-style apps serve /me/… twins of those paths (Graph: /me ≡ /users/{signed-in-user}) — both resolve to whatever this header (or the default MCP user) points at. An explicit path email always wins over the header. The unified MCP server does not send this header — it relies on the per-instance default — so it is primarily for direct REST/HTTP callers."
}

schemas

SupportIssue

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "example": "SUP-1001"
    },
    "prefix_id": {
      "type": "string",
      "readOnly": true
    },
    "notion_page_id": {
      "type": "string",
      "readOnly": true
    },
    "title": {
      "type": "string"
    },
    "summary": {
      "type": "string",
      "nullable": true
    },
    "status": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "nullable": true
    },
    "account_name": {
      "type": "string",
      "nullable": true
    },
    "tenant_id": {
      "type": "string",
      "nullable": true
    },
    "product_area": {
      "type": "string",
      "nullable": true
    },
    "assignment_group": {
      "type": "string",
      "nullable": true
    },
    "assignment_group_intake": {
      "type": "string",
      "nullable": true
    },
    "urgency_level": {
      "type": "string",
      "nullable": true
    },
    "urgency_justification": {
      "type": "string",
      "nullable": true
    },
    "troubleshooting_steps_attempted": {
      "type": "string",
      "nullable": true
    },
    "intake_requirements": {
      "type": "string",
      "nullable": true
    },
    "resolution_type": {
      "type": "string",
      "nullable": true
    },
    "resolution_readback": {
      "type": "string",
      "nullable": true
    },
    "case_owner": {
      "type": "string",
      "nullable": true,
      "description": "Case owner's email"
    },
    "support_l3_manager": {
      "type": "string",
      "nullable": true,
      "description": "L3 support manager's email"
    },
    "pm": {
      "type": "string",
      "nullable": true,
      "description": "PM's email"
    },
    "eng_manager": {
      "type": "string",
      "nullable": true,
      "description": "Engineering manager's email"
    },
    "gpm": {
      "type": "string",
      "nullable": true,
      "description": "Group PM's email"
    },
    "eng_director": {
      "type": "string",
      "nullable": true,
      "description": "Engineering director's email"
    },
    "created_time": {
      "type": "string",
      "nullable": true
    },
    "ticket_raised_on": {
      "type": "string",
      "nullable": true
    },
    "escalated_on": {
      "type": "string",
      "nullable": true
    },
    "scoping_date": {
      "type": "string",
      "nullable": true
    },
    "commit_date": {
      "type": "string",
      "nullable": true
    },
    "resolved_on": {
      "type": "string",
      "nullable": true
    },
    "closed_on": {
      "type": "string",
      "nullable": true
    },
    "assigned_to_rnd_on": {
      "type": "string",
      "nullable": true
    },
    "assigned_to_ps_on": {
      "type": "string",
      "nullable": true
    },
    "assigned_to_caseowner_on": {
      "type": "string",
      "nullable": true
    },
    "assigned_to_eng_on": {
      "type": "string",
      "nullable": true
    },
    "linear_issue_url": {
      "type": "string",
      "nullable": true
    },
    "high_urgency_channel_url": {
      "type": "string",
      "nullable": true
    },
    "eng_involved": {
      "type": "boolean"
    },
    "archived": {
      "type": "boolean"
    },
    "violations": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

ProductEscalation

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "example": "PE-1001"
    },
    "prefix_id": {
      "type": "string",
      "readOnly": true
    },
    "notion_page_id": {
      "type": "string",
      "readOnly": true
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "urgency": {
      "type": "string",
      "nullable": true
    },
    "account_name": {
      "type": "string",
      "nullable": true
    },
    "account_id": {
      "type": "string",
      "nullable": true
    },
    "product_area": {
      "type": "string",
      "nullable": true
    },
    "product_dri": {
      "type": "string",
      "nullable": true,
      "description": "Product DRI's email"
    },
    "product_sponsor": {
      "type": "string",
      "nullable": true,
      "description": "Product sponsor's email"
    },
    "account_escalation_owner": {
      "type": "string",
      "nullable": true,
      "description": "Account escalation owner's email"
    },
    "created_date": {
      "type": "string",
      "nullable": true
    },
    "committed_date": {
      "type": "string",
      "nullable": true
    },
    "next_check_in_date": {
      "type": "string",
      "nullable": true
    },
    "resolved_date": {
      "type": "string",
      "nullable": true
    },
    "capabilities_requested": {
      "type": "string",
      "nullable": true
    },
    "impact": {
      "type": "string",
      "nullable": true
    },
    "resolution_strategy": {
      "type": "string",
      "nullable": true
    },
    "next_steps_log": {
      "type": "string",
      "nullable": true
    },
    "pe_slack_channel_id": {
      "type": "string",
      "nullable": true
    },
    "linear_project_url": {
      "type": "string",
      "nullable": true
    },
    "opportunity": {
      "type": "object",
      "nullable": true
    },
    "updates": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "archived": {
      "type": "boolean"
    },
    "violations": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

RoadmapItem

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "example": "REL-1001"
    },
    "release_id": {
      "type": "string",
      "readOnly": true
    },
    "linear_project_id": {
      "type": "string",
      "readOnly": true
    },
    "linear_url": {
      "type": "string",
      "nullable": true
    },
    "name": {
      "type": "string"
    },
    "linear_name": {
      "type": "string",
      "nullable": true
    },
    "type": {
      "type": "string"
    },
    "status": {
      "type": "string"
    },
    "release_type": {
      "type": "string",
      "nullable": true
    },
    "product_area": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "skus": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "description": {
      "type": "string",
      "nullable": true
    },
    "short_description": {
      "type": "string",
      "nullable": true
    },
    "writeup": {
      "type": "string",
      "nullable": true
    },
    "is_roadmap": {
      "type": "boolean"
    },
    "publish_visibility": {
      "type": "string",
      "nullable": true
    },
    "assignee": {
      "type": "string",
      "nullable": true,
      "description": "Project lead's email"
    },
    "opm": {
      "type": "string",
      "nullable": true,
      "description": "Outbound PM's email"
    },
    "community_idea_name": {
      "type": "string",
      "nullable": true
    },
    "community_idea_url": {
      "type": "string",
      "nullable": true
    },
    "start_date": {
      "type": "string",
      "nullable": true
    },
    "limited_preview_date": {
      "type": "string",
      "nullable": true
    },
    "release_date": {
      "type": "string",
      "nullable": true
    },
    "ca_program": {
      "type": "string",
      "nullable": true
    },
    "template_content": {
      "type": "object"
    },
    "milestones": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "product_memo_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "data_center_exceptions": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  }
}

Account

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "example": "ACC-0001"
    },
    "name": {
      "type": "string"
    },
    "sfdc_id": {
      "type": "string",
      "nullable": true
    },
    "notion_id": {
      "type": "string",
      "nullable": true
    },
    "segment": {
      "type": "string",
      "nullable": true
    },
    "tenant_id": {
      "type": "string",
      "nullable": true
    },
    "data_center": {
      "type": "string",
      "nullable": true
    },
    "account_owner": {
      "type": "string",
      "nullable": true,
      "description": "Account owner's email"
    },
    "open_support_issues": {
      "type": "integer"
    },
    "open_product_escalations": {
      "type": "integer"
    }
  }
}

SupportComment

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true,
      "example": "COM-0001"
    },
    "support_issue_id": {
      "type": "string"
    },
    "comment": {
      "type": "string"
    },
    "author": {
      "type": "string",
      "nullable": true,
      "description": "Comment author's email"
    },
    "mention_user_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "created_at": {
      "type": "string",
      "nullable": true
    }
  }
}

Document metadata and extensions

{
  "openapi": "3.0.0",
  "info": {
    "title": "Purple Product Ops API",
    "version": "1.0.0",
    "description": "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.\n\n---\n\n**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`."
  },
  "security": [
    {
      "patAuth": []
    }
  ]
}