List projects for device assignment
| Method | Path |
|---|---|
GET | /v1/slim/device/assign/project |
Authentication · Access policies
Lists the projects you can move a device into: your own project, its parent project and its sub-projects.
Auth: bearer token. The caller must be a practitioner, an admin or a System Owner, and needs Device:update.
Scope: the caller's project (from the token) and its parent and sub-projects.
Behaviour
- Each entry is
{ project: { id, name } }.nameis an empty string when the project has none. totalis the number of projects returned.- Read-only.
Example
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/device/assign/project' \
-H "Authorization: Bearer ${OVOK_TOKEN}"
Successful response
200 — Projects a device can be moved into.
Errors
| Status | Meaning |
|---|---|
401 | Bearer token is missing, invalid or expired. |
403 | You are not a practitioner, admin or System Owner, you lack Device:update, or your session has no project. |