Skip to content
HeyX API

Create Problem

Required scope: problem:create

Creates a portfolio-linked problem with optional assignees, labels, and manual tasks. Assignee IDs are account IDs returned by ListMembers. Template and workflow configuration are intentionally not exposed.

Generated Reference
POST /public-api/publicapi.v1.Problem/CreateProblem

Creates a portfolio-linked problem. This operation is not idempotent.

Request CreateProblemRequest
Response CreateProblemResponse

CreateProblemRequest

Field Type Description
portfolio_id string
title string
description string
severity int32
assignee_ids repeated string Account IDs returned by ListMembers.
tasks repeated CreateProblemTaskInput
labels repeated ProblemLabel

CreateProblemResponse

Field Type
problem Problem

Related Types

CreateProblemTaskInput

Field Type
body string

ProblemLabel

Field Type
id optional string
name string
color_hex string

Problem

Field Type
id string
title string
description string
status ProblemStatus
severity int32
portfolio_id optional string
problem_template_id optional string
problem_template_name string
assignees repeated ProblemAssignee
labels repeated ProblemLabel
resolved_at optional int64
closed_at optional int64
archived_at optional int64
created_at int64
updated_at int64
total_tasks int32
completed_tasks int32

ProblemAssignee

Field Type
id string
display_name string
kind string 
{
  "portfolioId": "<portfolio-id>",
  "title": "Inspection follow-up",
  "description": "Check the inverter installation",
  "severity": 3,
  "assigneeIds": ["<account-id>"],
  "tasks": [{ "body": "Schedule a site visit" }]
}

This operation is not idempotent. Do not blindly retry after a timeout.

HeyX API