Skip to content
API Reference/Organization/
Acquire an access token

HEMS APIs (1.0.0)

APIs for Home Energy Management System

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server
https://docs-hems.obeliskapp.com/_mock/apis/openapi
Production server
https://ems.obeliskapp.com

Organization

Operations

Acquire an access token

Request

Acquire an access token for accessing devices and users endpoints

Security
bearerAuth
Bodyapplication/jsonrequired
organizationIdstring(id)required
secretstringrequired
curl -i -X POST \
  https://docs-hems.obeliskapp.com/_mock/apis/openapi/organization/auth/token \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "organizationId": "string",
    "secret": "string"
  }'

Responses

Default Response

Bodyapplication/json
accessTokenstringrequired
expiresInnumberrequired
scopeArray of stringsrequired
Any of:
string
Value"devices:read"
Response
application/json
{
  "accessToken": "string",
  "expiresIn": 0,
  "scope": [
    "devices:read"
  ]
}

User

Operations

Device

Operations