{"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`."},"servers":[{"url":"https://marketplace.moveworks.com/api/purple-suite/product-ops"}],"security":[{"patAuth":[]}],"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}}}}},"paths":{"/support-issues":{"get":{"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}},"/support-issues/{id}":{"get":{"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}},"/escalations":{"get":{"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}},"/escalations/{id}":{"get":{"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}},"/roadmap-items":{"get":{"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}},"/roadmap-items/{id}":{"get":{"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}},"/accounts":{"get":{"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}},"/accounts/{id}":{"get":{"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}},"/comments":{"get":{"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}},"/comments/{id}":{"get":{"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}},"/lookup/support-issues":{"get":{"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"}}}},"/lookup/support-issues/{identifier}":{"get":{"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"}}}},"/lookup/support-issues/{identifier}/violations":{"get":{"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"}}}},"/actions/support-issues/{identifier}/comments":{"post":{"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"}}}},"/actions/support-issues/{identifier}/resolve":{"post":{"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"}}}},"/lookup/escalations":{"get":{"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"}}}},"/lookup/escalations/{identifier}":{"get":{"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"}}}},"/lookup/escalations/{identifier}/violations":{"get":{"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"}}}},"/actions/escalations/update":{"post":{"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"}}}},"/lookup/roadmap-search":{"get":{"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"}}}},"/lookup/roadmap-items/{identifier}":{"get":{"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"}}}},"/lookup/roadmap-releases":{"get":{"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"}}}},"/lookup/roadmap-product-areas":{"get":{"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"}}}},"/lookup/roadmap-readiness":{"post":{"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"}}}},"/actions/roadmap-items/update":{"post":{"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"}}}},"/lookup/accounts":{"get":{"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"}}}},"/lookup/accounts/{identifier}":{"get":{"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"}}}},"/lookup/users":{"get":{"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"}}}},"/lookup/sla-definitions":{"get":{"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"}}}}}}