Skip to main content
POST
/
v1
/
entity
Create Entity
curl --request POST \
  --url https://api.app.reva.ai/v1/entity \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "entityId": "12345",
  "attributes": [
    {
      "name": "color",
      "value": "blue"
    }
  ],
  "parents": [
    {
      "entityId": "parent-001",
      "entityType": "Department"
    }
  ],
  "children": [
    {
      "entityId": "child-001",
      "entityType": "Team"
    }
  ]
}'
{
  "entityId": "12345",
  "entityTypeId": "abcde-1234"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
entityTypeId
string
required

Unique identifier for the entity type.

To find the entityTypeId, follow these steps:

  • From the left menu, navigate to an Application -> Environment -> Policy Store
  • Click on the "Data" tab.
  • Here you will see a list of all Entity Types along with their IDs. Copy the ID of the entity type you want to use.

Body

application/json

DTO representing a Reva entity with attributes, parents, and children.

​
entityId
string
required

Unique identifier of the entity.

Example:

"12345"

​
attributes
object[]

Set of attributes associated with the entity.

​
parents
object[]

Set of parent entities related to this entity.

​
children
object[]

Set of child entities related to this entity.

Response

Created

​
entityId
string

Unique identifier of the entity

Example:

"12345"

​
entityTypeId
string

Unique type identifier of the entity

Example:

"abcde-1234"

⌘I