---
title: "POST /workspaces/{workspaceId}/entity-properties"
method: POST
path: "/workspaces/{workspaceId}/entity-properties"
---

# POST /workspaces/{workspaceId}/entity-properties

`POST /workspaces/{workspaceId}/entity-properties`

Sets values for multiple time series properties.

## Path parameters

- `workspaceId` string, required

## Request body

- object
  - `entries` PropertyValueEntry[], required — An object that maps strings to the property value entries to set. Each string in the mapping must be unique to this object.
    - `entityPropertyReference` object, required — An object that contains information about the entity that has the property.
      - `componentName` string — The name of the component.
      - `componentPath` string — This string specifies the path to the composite component, starting from the top-level component.
      - `externalIdProperty` object — A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.
      - `entityId` string — The ID of the entity.
      - `propertyName` string, required — The name of the property.
    - `propertyValues` PropertyValue[] — A list of objects that specify time series property values.
      - `timestamp` string, date-time — The timestamp of a value for a time series property.This field is deprecated and will throw an error in the future. Use time instead.
      - `value` object, required — An object that specifies a value for a time series property.
        - `booleanValue` boolean — A Boolean value.
        - `doubleValue` number, double — A double value.
        - `integerValue` integer — An integer value.
        - `longValue` integer — A long value.
        - `stringValue` string — A string value.
        - `listValue` DataValue[] — A list of multiple values.
          - `booleanValue` boolean — A Boolean value.
          - `doubleValue` number, double — A double value.
          - `integerValue` integer — An integer value.
          - `longValue` integer — A long value.
          - `stringValue` string — A string value.
          - `listValue` DataValue[] — A list of multiple values.
          - `mapValue` object — An object that maps strings to multiple <code>DataValue</code> objects.
          - `relationshipValue` object — A value that relates a component to another component.
            - `targetEntityId` string — The ID of the target entity associated with this relationship value.
            - `targetComponentName` string — The name of the target component associated with the relationship value.
          - `expression` string — An expression that produces the value.
        - `mapValue` object — An object that maps strings to multiple <code>DataValue</code> objects.
        - `relationshipValue` object — A value that relates a component to another component.
          - `targetEntityId` string — The ID of the target entity associated with this relationship value.
          - `targetComponentName` string — The name of the target component associated with the relationship value.
        - `expression` string — An expression that produces the value.
      - `time` string — <p>ISO8601 DateTime of a value for a time series property.</p> <p>The time for when the property value was recorded in ISO 8601 format: <i>YYYY-MM-DDThh:mm:ss[.SSSSSSSSS][Z/±HH:mm]</i>.</p> <ul> <li> <p> <i>[YYYY]</i>: year</p> </li> <li> <p> <i>[MM]</i>: month</p> </li> <li> <p> <i>[DD]</i>: day</p> </li> <li> <p> <i>[hh]</i>: hour</p> </li> <li> <p> <i>[mm]</i>: minute</p> </li> <li> <p> <i>[ss]</i>: seconds</p> </li> <li> <p> <i>[.SSSSSSSSS]</i>: additional precision, where precedence is maintained. For example: [.573123] is equal to 573123000 nanoseconds.</p> </li> <li> <p> <i>Z</i>: default timezone UTC</p> </li> <li> <p> <i>± HH:mm</i>: time zone offset in Hours and Minutes.</p> </li> </ul> <p> <i>Required sub-fields</i>: YYYY-MM-DDThh:mm:ss and [Z/±HH:mm]</p>

## Response `200`

Success

- BatchPutPropertyValuesResponse
  - `errorEntries` BatchPutPropertyErrorEntry[], required — Entries that caused errors in the batch put operation.
    - `errors` BatchPutPropertyError[], required — A list of objects that contain information about errors returned by the <code>BatchPutProperty</code> action.
      - `errorCode` string, required — The error code.
      - `errorMessage` string, required — The error message.
      - `entry` object, required — An object that contains information about errors returned by the <code>BatchPutProperty</code> action.
        - `entityPropertyReference` object, required — An object that contains information about the entity that has the property.
          - `componentName` string — The name of the component.
          - `componentPath` string — This string specifies the path to the composite component, starting from the top-level component.
          - `externalIdProperty` object — A mapping of external IDs to property names. External IDs uniquely identify properties from external data stores.
          - `entityId` string — The ID of the entity.
          - `propertyName` string, required — The name of the property.
        - `propertyValues` PropertyValue[] — A list of objects that specify time series property values.
          - `timestamp` string, date-time — The timestamp of a value for a time series property.This field is deprecated and will throw an error in the future. Use time instead.
          - `value` object, required — An object that specifies a value for a time series property.
            - `booleanValue` boolean — A Boolean value.
            - `doubleValue` number, double — A double value.
            - `integerValue` integer — An integer value.
            - `longValue` integer — A long value.
            - `stringValue` string — A string value.
            - `listValue` DataValue[] — A list of multiple values.
              - …
            - `mapValue` object — An object that maps strings to multiple <code>DataValue</code> objects.
            - `relationshipValue` object — A value that relates a component to another component.
              - …
            - `expression` string — An expression that produces the value.
          - `time` string — <p>ISO8601 DateTime of a value for a time series property.</p> <p>The time for when the property value was recorded in ISO 8601 format: <i>YYYY-MM-DDThh:mm:ss[.SSSSSSSSS][Z/±HH:mm]</i>.</p> <ul> <li> <p> <i>[YYYY]</i>: year</p> </li> <li> <p> <i>[MM]</i>: month</p> </li> <li> <p> <i>[DD]</i>: day</p> </li> <li> <p> <i>[hh]</i>: hour</p> </li> <li> <p> <i>[mm]</i>: minute</p> </li> <li> <p> <i>[ss]</i>: seconds</p> </li> <li> <p> <i>[.SSSSSSSSS]</i>: additional precision, where precedence is maintained. For example: [.573123] is equal to 573123000 nanoseconds.</p> </li> <li> <p> <i>Z</i>: default timezone UTC</p> </li> <li> <p> <i>± HH:mm</i>: time zone offset in Hours and Minutes.</p> </li> </ul> <p> <i>Required sub-fields</i>: YYYY-MM-DDThh:mm:ss and [Z/±HH:mm]</p>

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/iottwinmaker.md) · [All operations](https://skmtc.net/aws/apis/iottwinmaker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iottwinmaker/versions/a66a26fd65ea/schema)