Reauthenticate a user's heat pump - Podero Documentation

POST

api

partners

v2.0

org

{org_id}

users

{user_id}

heat-pumps

{heat_pump_id}

auth_session

Reauthenticate a user's heat pump

curl --request POST \
  --url https://api.example.com/api/partners/v2.0/org/{org_id}/users/{user_id}/heat-pumps/{heat_pump_id}/auth_session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "success_url": "<string>",
  "cancel_url": "<string>"
}
'

{
  "authentication_url": "<string>",
  "device_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id

string<uuid>

required

The organization ID of the user's organization

user_id

string<uuid>

required

The user ID of the user whom the heat pump belongs to

heat_pump_id

string<uuid>

required

The ID of the heat pump to be reauthenticated

Body

application/json

success_url

string | null

cancel_url

string | null

Response

200 - application/json

authentication_url

string | null

device_id

string<uuid> | null

session_id

string<uuid> | null

Get a user's solar invertersList all solar inverters of a specific user under a specific organization.

Reauthenticate a user's heat pump

curl --request POST \
  --url https://api.example.com/api/partners/v2.0/org/{org_id}/users/{user_id}/heat-pumps/{heat_pump_id}/auth_session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "success_url": "<string>",
  "cancel_url": "<string>"
}
'

{
  "authentication_url": "<string>",
  "device_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}