### Security: chx_auth_session

Source: https://connhex.com/api/devices-ownerships/latest/api.json

Security scheme: chx_auth_session

```markdown
## Security: chx_auth_session

**Description:** Security scheme: chx_auth_session

**Type:** apiKey


```

--------------------------------

### POST /ownerships

Source: https://connhex.com/api/devices-ownerships/latest/api.json

Allows users to claim ownership of a physical device.

       Calling this endpoint validates the device against the Manufacturing Service,
       provisions it as an active entity in the Resources Service, and automatically
       updates the user's policies to grant access to the device's data.

       [Read the Internal Workflow documentation](https://connhex.com/docs/devices-ownerships/internal-workflow) for a complete step-by-step architectural breakdown.
    .

Required Permission:

- Resource: ```resource:devices```

- Action: ```resource:devices:register```

```markdown
### Request Body

**Content-Type:** application/json

- **deviceId** (string) (required): Identifier of the device for which ownership is requested (e.g. serial number) (example: "CTP-0139836")

### Responses

#### 201 - response

**CreatedResourceDto**
- **resourceId** (string) (required): The id of the created resource

#### 403 - response

#### 404 - response

### Example Usage

```bash
curl -X POST "https://apis.<domain>/ownerships" \
  -H "Content-Type: application/json" \
  -d '{
  "deviceId": "CTP-0139836"
}'
```

```

--------------------------------

### Schema: CreateOwnershipDto

Source: https://connhex.com/api/devices-ownerships/latest/api.json

Schema definition for CreateOwnershipDto

```markdown
## Schema: CreateOwnershipDto

Schema definition for CreateOwnershipDto

**Type:** object

- **deviceId** (string) (required): Identifier of the device for which ownership is requested (e.g. serial number) (example: "CTP-0139836")

```

--------------------------------

### API Overview: connhex-devices-ownerships

Source: https://connhex.com/api/devices-ownerships/latest/api.json

OpenAPI specification version 1.0.2

```yaml
# connhex-devices-ownerships
# Version: 1.0.2

OpenAPI specification

# Base URL: https://apis.<domain>
```

--------------------------------

### Security: bearer

Source: https://connhex.com/api/devices-ownerships/latest/api.json

Security scheme: bearer

```markdown
## Security: bearer

**Description:** Security scheme: bearer

**Type:** http

**Scheme:** bearer


```

--------------------------------

### Schema: CreatedResourceDto

Source: https://connhex.com/api/devices-ownerships/latest/api.json

Schema definition for CreatedResourceDto

```markdown
## Schema: CreatedResourceDto

Schema definition for CreatedResourceDto

**Type:** object

- **resourceId** (string) (required): The id of the created resource

```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.