List child project relationships
| Method | Path |
|---|---|
GET | /v1/slim/project/child |
Authentication · Access policies
Returns your current project together with its parent project and its direct child projects. Use it to build a project switcher or hierarchy view.
Auth: Bearer token for a practitioner, project admin or System Owner session. The caller's access policy must grant AccessPolicy:read (project admins skip this check).
Scope: The caller's project (from the token).
Behaviour
currentProjectis the caller's project.parentProjectis the project your project is a child of, ornullwhen it has none.childProjectslists every direct child, with no cap. Grandchildren are not included.- A child whose project no longer exists is left out.
- Each project carries
name(the project id when it has none),address,contactandsettings.settings.timeZonedefaults toEurope/Berlin;settings.trendsPerioddefaults tostart: "09:00:00"anddurationSeconds: 86400. GET /v2/slim/project/childreturns the same lists with a device count per project.
Example
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/project/child' \
-H "Authorization: Bearer ${OVOK_TOKEN}"
Successful response
200 — Project relationships retrieved successfully.
Errors
| Status | Meaning |
|---|---|
401 | The bearer token is missing or invalid, or the session carries no project. |
403 | The session is not a practitioner, admin or System Owner session, or its access policy lacks AccessPolicy:read. |