API Reference

The Security API endpoints provide an interface for interacting with security-related objects and actions.

LoginActivity

Properties

NameTypeDescriptionRestrictions
citystring
contextstring
countrystring
created_atstring
failure_reasonstring
idIDThe unique identifier of a resource (can be a GUID).
identitystring
ipstring
regionstring
successboolean
user_idIDThe unique identifier of a resource (can be a GUID).

Example

{
  "city": "string",
  "context": "string",
  "country": "string",
  "created_at": "string",
  "failure_reason": "string",
  "id": "74",
  "identity": "string",
  "ip": "string",
  "region": "string",
  "success": true,
  "user_id": "74"
}

Activity

Properties

NameTypeDescriptionRestrictions
created_atstring
idIDThe unique identifier of a resource (can be a GUID).
keystring
owner_idIDThe unique identifier of a resource (can be a GUID).
owner_typestring
parametersobject
parameters.idIDThe unique identifier of a resource (can be a GUID).
recipient_idIDThe unique identifier of a resource (can be a GUID).
recipient_typestring
trackable_idIDThe unique identifier of a resource (can be a GUID).
trackable_typestring
updated_atstring

Example

{
  "created_at": "string",
  "id": "74",
  "key": "string",
  "owner_id": "74",
  "owner_type": "string",
  "parameters": {
    "id": "74"
  },
  "recipient_id": "74",
  "recipient_type": "string",
  "trackable_id": "74",
  "trackable_type": "string",
  "updated_at": "string"
}

ActivityResponse

Properties

NameTypeDescriptionRestrictions
data[Activity][An object representing an event within chains.]

Example

{
  "data": [
    {
      "created_at": "string",
      "id": "74",
      "key": "string",
      "owner_id": "74",
      "owner_type": "string",
      "parameters": {
        "id": "74"
      },
      "recipient_id": "74",
      "recipient_type": "string",
      "trackable_id": "74",
      "trackable_type": "string",
      "updated_at": "string"
    }
  ]
}

User

Properties

NameTypeDescriptionRestrictions
created_atstring
emailstring
first_namestring¦null
idIDThe unique identifier of a resource (can be a GUID).
last_namestring¦null
last_sign_in_atstring¦null
sso_enabledboolean

Example

{
  "created_at": "string",
  "email": "string",
  "first_name": "string",
  "id": "74",
  "last_name": "string",
  "last_sign_in_at": "string",
  "sso_enabled": true
}

UserGroup

Properties

NameTypeDescriptionRestrictions
created_atstring
defaultboolean
idIDThe unique identifier of a resource (can be a GUID).
namestring

Example

{
  "created_at": "string",
  "default": true,
  "id": "74",
  "name": "string"
}

Permission

Properties

NameTypeDescriptionRestrictions
idIDThe unique identifier of a resource (can be a GUID).
namestring
object_idIDThe unique identifier of a resource (can be a GUID).
object_namestring
object_typestring
user_groups[UserGroup][An object containing information about a particular group in Chains.]

Enumerated Values

PropertyValue
nameread
nameexecute
namewrite
namecreate
nameadmin

Example

{
  "id": "74",
  "name": "read",
  "object_id": "74",
  "object_name": "string",
  "object_type": "string",
  "user_groups": [
    {
      "created_at": "string",
      "default": true,
      "id": "74",
      "name": "string"
    }
  ]
}