> For the complete documentation index, see [llms.txt](https://docs.depinscan.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.depinscan.io/ownership.md).

# Ownership

Manage device ownership for a project

## Set or update device ownership for a project

> Creates or updates the ownership mapping for a device within the specified project.

```json
{"openapi":"3.0.3","info":{"title":"DepinScan Ownership API","version":"1.0.0"},"tags":[{"name":"Ownership","description":"Manage device ownership for a project"}],"servers":[{"url":"https://api.depinscan.io","description":"Production"}],"security":[{"AuthorizationHeader":[]}],"components":{"securitySchemes":{"AuthorizationHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Pass your token in the `Authorization` header. Example: `mc.<token>`\n"}},"schemas":{"OwnershipRequest":{"type":"object","required":["publisher","owner"],"properties":{"publisher":{"type":"string","description":"Device identifier or publisher ID"},"owner":{"type":"string","description":"Ethereum address of the device owner","pattern":"^0x[a-fA-F0-9]{40}$"}}},"OwnershipResponse":{"type":"object","description":"Generic success body (replace with real response once available)","properties":{"status":{"type":"string"},"message":{"type":"string"}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}}}},"paths":{"/api/project/{projectId}/ownership":{"post":{"tags":["Ownership"],"summary":"Set or update device ownership for a project","description":"Creates or updates the ownership mapping for a device within the specified project.","operationId":"createOrUpdateOwnership","parameters":[{"name":"projectId","in":"path","required":true,"description":"Project identifier (UUID)","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnershipRequest"}}}},"responses":{"200":{"description":"Ownership recorded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OwnershipResponse"}}}},"400":{"description":"Bad request (validation errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized (missing/invalid auth)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden (insufficient permissions)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Project not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```