Beta
Idempotent
Workspace scope

Set device owner

​

Make a user the owner of the device. The device sync keeps this owner. The desktop agent of the device can then sign in with its device certificate. Answers 422 with data.code user_not_in_company when the user is not a user of the workspace of the device, or is archived.

Path Parameters

  • Integer numbers.

Headers

  • Optional client-generated key. Reusing the same key with an identical request replays the original response instead of enqueueing a duplicate task.

  • Optional workspace id. Absent, the route serves the workspace of the credential. An API key can only name its own workspace. A bearer token can name a workspace where its person is an admin member.

Body·

required
application/json
  • A user of the workspace of the device. The user must not be archived.

Responses

  • OK

    • The identifier of the device in the device management tool.

    • Integer numbers.

    • The applications the desktop agent of the owner reports as installed. 0 when the owner has no agent. Null for a device with no owner, or with no agent for its operating system.

    • The latest of the last contact of the device management tool and of the last report of the desktop agent of the owner. ISO 8601 format. The agent report has a day precision.

    • The name the device management tool gives the device.

    • The OS agent of the owner (the Corma desktop agent). connected: a report in the last 7 days. inactive: an older report. not_installed: no report, or no owner. not_available: no agent exists for this operating system.

      values
      connectedinactivenot_installednot_available
    • The operating system version, as the device management tool reports it. Intune reports a build number.

    • The user who owns the device. Null when none.

      Properties: 3
    • True when an admin set the owner. The device sync keeps that owner.

    • The device management connection that reports the device.

      Properties: 5
    • For a device with no owner, the user that the device management tool names: the one user whose primary email has the same local part as the email of the tool, else the one user whose name equals the user name of the tool, case-insensitive. Archived users do not count. Null when the device has an owner, or when no user or several users match.

      Properties: 3
    • The workspace the item belongs to.

      Properties: 3
    Headers
    Headers: 1
    application/json
put/devices/{id}/owner
{
  "id": -9007199254740991,
  "workspace": {
    "id": -9007199254740991,
    "name": "string",
    "logoUrl": "https://example.com"
  },
  "name": "string",
  "externalId": "string",
  "serialNumber": "string",
  "udid": "string",
  "os": "windows",
  "osVersion": "string",
  "source": {
    "connectionId": -9007199254740991,
    "kind": "google",
    "method": "api",
    "name": "string",
    "connectionName": "string"
  },
  "owner": {
    "id": "string",
    "fullName": "string",
    "email": "string"
  },
  "suggestedOwner": {
    "id": "string",
    "fullName": "string",
    "email": "string"
  },
  "ownerAssignedManually": true,
  "osAgentStatus": "connected",
  "installedAppsCount": -9007199254740991,
  "lastContactAt": "2026-11-12T18:52:12.913Z"
}