HomeGuidesAPI ReferenceChangelog
Terms of Use
API Reference

Issues / Create

Create a new issue. Note - the system-controlled status auto_recovery_in_progress cannot be set via API.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Payload for creating a new issue

integer | null

The operator ID for this issue.
Optional for global admin tokens (defaults to creating a global issue if not provided).
Ignored for operator-scoped tokens (uses the token's operator).

integer | null

The partner the issue is attributed to. It cannot be changed after creation: an update request containing partnerId is rejected with 422.
Required for sub-operator tokens: must be one of the sub-operator's partners with access to issues; the issue is attributed to that partner. A request without partnerId, or with another partner, is rejected with 422.
Ignored for partner tokens (the issue is attributed to the token's partner).
Optional for operator and global tokens: must be a partner of the issue's operator, so a global token must also send that operator's operatorId. When omitted or null, the issue is created at operator level.

string
required
length ≤ 255

Issue title

string | null
required

Detailed issue description (HTML content)

string
enum
required

Issue category:

  • network: Network connectivity or communication issues
  • payments_billing: Payment processing or billing-related issues
  • product_offerings: Issues with product features or tariff offerings
  • ev_driver_ux: EV driver user experience issues
  • security: Security-related concerns or incidents
  • reporting: Reporting or analytics issues
  • roaming: Roaming-related issues
  • external_services: Failures of external services that the platform exchanges data with
  • other: Issues not covered by other categories
string
enum
required

Issue severity level:

  • severe: Critical impact requiring immediate attention
  • significant: Major impact affecting important functionality
  • moderate: Moderate impact with workaround available
  • low: Minor impact with minimal effect on operations
Allowed:
string
enum
required

Issue priority level:

  • highest: Must be addressed immediately
  • high: Should be addressed as soon as possible
  • medium: Should be addressed in normal workflow
  • low: Can be addressed when convenient
Allowed:
string
enum
Defaults to new

Issue status. Defaults to 'new' if not provided.
Note: The system-controlled status auto_recovery_in_progress cannot be set via API and will be rejected with a validation error.

string | null

External system identifier (UUID format recommended)

integer | null

ID of the admin user to assign this issue to

keyResource
object | null

Primary resource this issue is related to (e.g., charge point, location, or EVSE).
Once set, this cannot be changed via update operations.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json