# Link a Label to an Asset

**POST /assets/{assetId}/labels**




## Servers
- The production URL for sending requests to the Reelables API.: https://api.reelables.com/v1 (The production URL for sending requests to the Reelables API.)


## Authentication methods
- Auth endpoint


## Parameters
### Headers
- **request-id** (string)
  Unique identifier for the API request. Example: f7ecf495-ca1c-4468-a6c2-6ee3f723fa00

### Path parameters
- **assetId** (string)
  The identifier of the Asset


### Body: application/json (object)

- **replaceExistingLabel** (boolean)
  Indicate whether to replace the existing Label, in the case where the Asset is already linked to a Label
- **nfcId** (string)
  Label NFC identifier, used when creating an Asset and linking a Label at the same time. Example: '0000007B'


## Responses
### 200
200 response

#### Body: application/json (object)
- **inSpaces** (array[object])

- **temperatures** (object)

- **name** (string)
  The name of the Asset
- **locations** (object)

- **id** (string)
  Unique identifier of the Asset. Example: '00Es43YBJfNRXNSvLmni'
- **label** (object)

- **createdOn** (string(date-time))
  Date that the Asset was created, in UTC. Example: '2019-07-21T17:32:28Z'
- **workspaceId** (string(uuid))
  Unique identifier of the workspace. Example: 'd290f1ee-6c54-4b01-90e6-d701748f0851'

### 401
Unauthorized

#### Body: application/json (object)
- **errors** (array[object])


### 403
Forbidden

#### Body: application/json (object)
- **errors** (array[object])


### 404
Asset not found

#### Body: application/json (object)
- **errors** (array[object])


### 429
Too Many Requests

#### Body: application/json (object)
- **errors** (array[object])



[Powered by Bump.sh](https://bump.sh)