Charge Point / Change Owner

post

https://{tenantUrl}/public-api/actions/charge-point/v1.0/{chargePoint}/change-owner

Change the owner of the Charge Point

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chargePoint

integer

required

Body Params

userId

integer | null

This User would become the owner of the personal charge point. If left empty - no Owner would be assigned. The User must be one the API token is allowed to view (the same users returned by the users list endpoint, excluding ad hoc users); otherwise, including when the userId does not exist or is a deleted user, the request is rejected with 422 and the error The selected user id is invalid. on userId, and the owner is left unchanged.

churnReason

object

Optional churn reason stored on the previous owner's exit in the churn record. Only allowed when the charge point has a user owner and userId removes or replaces it; otherwise it returns a validation error. The reason must apply to users. Custom reasons allow the chose_to_leave, forced and circumstances_changed exit types. Send an empty object or omit it to record no reason. Without it, the exit is recorded as forced with no reason.

Responses

202

Action accepted

406

Action rejected

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

401Access token is missing or invalid

403You do not have permission to perform the action. When the organisation of the admin behind the token has view-only access, every write is refused with the message "Your access is view-only."

404The record is not found

422The payload you provided is invalid

429Too many requests. Please try again later. For more information, please check the rate limit headers X-RateLimit-*