← Home

Zaikio Core

Core services of Zaikio, including Hub API, Loom API and OAuth API

Reference

# Loom Events

Here you will find a list of the Loom Events provided by the zaikio.

# zaikio.revoked_access_token

This event will be triggered every time an access token is revoked (e.g. because the user was banned). You must maintain this token in a list of revoked access tokens (for at least 1 hour).

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.revoked_access_token",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "payload": {
    "access_token_id":"b1a2eaa9-11ba-4cab-8580-40f091e37742" // Access Token ID (JTI) that was revoked
  },
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.established_connection

This event will be triggered every time an organization or person establishes a connection with your app, that did not have an active connection before. This event is only sent to your app.

The subject contains the subject to which the connection was established. It can be a person or an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.connection_changed

This event will be triggered every time an organization or person changes the actual or requested OAuth scopes of a connection with your app. This can for example happen, if the subject connects to another app, that your app requested scopes for or because another connection was removed and some scopes are not available anymore or because the subject granted requested scopes through Zaikio.

This event is only sent to your app.

The subject contains the subject to which the connection was established. It can be a person or an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251471b",
  "name": "zaikio.connection_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.revoked_connection

This event will be triggered every time an organization or person revoked a connection with your app, that did have an active connection before. This event is only sent to your app.

The subject contains the subject to which the connection was originally established. It can be a person or an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a", // could also be a Per
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.organization_details_changed

This event will be triggered every time organization details such as logo, kind or name changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "link": "https://hub.sandbox.zaikio/api/v1/organization"
}

# zaikio.person_details_changed

This event will be triggered every time a person's profile changed (such as name, language, avatar, ...). This event is triggered with a Person subject. If you want to listen to this event for an organization use member_details_changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.person_details_changed",
  "subject": "Per/dee4c43d-6a61-4b79-99fd-0035ddd6b887",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "link": "https://hub.sandbox.zaikio/api/v1/person"
}

# zaikio.subscription_*

We offer 5 events for subscriptions: created, plan_changed, payment_failed, payment_issues_resolved and canceled.

# zaikio.subscription_created

This event will be triggered every time a subscription was created for your app. This event is not fired, if a plan was upgraded or downgraded (instead it will fire zaikio.subscription_plan_changed).

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_created",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "advanced"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}

# zaikio.subscription_plan_changed

This event will be triggered every time an existing subscription changed its plan. This subscription has to be provisioned again.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_plan_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}

# zaikio.subscription_payment_failed

This event will be triggered when an invoice for a subscription was not paid within 1 week. You might forbid the organization access to premium features of your app.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_payment_failed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}

# zaikio.subscription_payment_issues_resolved

This event will be triggered after a zaikio.subscription_payment_failed was triggered before but the subscription's payment went back to normal. You should give the organization access to premium features of your app again.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_payment_issues_resolved",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/subscriptions/Organization-2b271d51-e447-4a16-810f-5abdc596700a"
}

# zaikio.subscription_canceled

This event will be triggered when a susbcription was canceled by the user. You should disable all premium features of your app for this organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.subscription_canceled",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "plan": "professional"
  }
}

# zaikio.billing_address_changed

This event will be triggered when an organization changed its billing address.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.billing_address_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.means_of_payment_changed

This event will be triggered when an organization changed its default means of payment.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.means_of_payment_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z"
}

# zaikio.machine_*

We offer 4 events for machines: added, site_changed, details_changed and removed.

# zaikio.machine_added

This event will be triggered every time a machine was assigned to an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.machine_details_changed

This event will be triggered every time the details such as kind, manufacturer or specification of a machine were updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.machine_site_changed

This event will be triggered every time the site of a machine was changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_site_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.machine_removed

This event will be triggered every time a machine was removed from an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.machine_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "machine_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  }
}

# zaikio.availability_*

We offer 3 events for availabilities: added, changed and removed.

# zaikio.availability_added

This event will be triggered every time an availability is assigned to an asset (machine or specialist).

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.availability_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/80ef6969-0b4d-4959-8833-875d601f0922/availabilities/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.availability_changed

This event will be triggered every time an availability is modified.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
    "name": "zaikio.availability_changed",
    "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
    "timestamp": "2019-11-26T10:58:09.664Z",
    "version": "1.0",
    "received_at": "2019-11-26T10:58:09.664Z",
    "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
      "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/machines/80ef6969-0b4d-4959-8833-875d601f0922/availabilities/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.availability_removed

This event will be triggered every time a availability is removed from an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
    "name": "zaikio.availability_removed",
    "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
    "timestamp": "2019-11-26T10:58:09.664Z",
    "version": "1.0",
    "received_at": "2019-11-26T10:58:09.664Z",
    "payload": {
    "availability_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
      "machine_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  }
}

# zaikio.specialist_*

We offer 4 events for specialist assets: added, site_changed, details_changed and removed.

# zaikio.specialist_added

This event will be triggered every time a specialist was assigned to an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.specialist_details_changed

This event will be triggered every time the details such as kind, vendor or specification of a specialist asset were updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.specialist_site_changed

This event will be triggered every time the site of a specialist was changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_site_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  },
  "link": "https://hub.sandbox.zaikio/api/v1/specialists/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.specialist_removed

This event will be triggered every time a specialist asset was removed from an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.specialist_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "specialist_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "site_id": "80ef6969-0b4d-4959-8833-875d601f0922" // can be null
  }
}

# zaikio.organization_*

We offer 3 events for organization members where the person is the subject: joined, roles_updated and left.

# zaikio.organization_joined

This event will be triggered every time a person was added to an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_joined",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a",
    "roles": 1 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/person/organization_memberships"
}

# zaikio.organization_roles_updated

This event will be triggered every time the roles of a member changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_roles_updated",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a",
    "roles": 2 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/person/organization_memberships"
}

# zaikio.organization_left

This event will be triggered every time a person was removed from an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.organization_left",
  "subject": "Per/80ef6969-0b4d-4959-8833-875d601f0922",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "organization_id": "2b271d51-e447-4a16-810f-5abdc596700a"
  }
}

# zaikio.member_*

We offer 4 events for organization members: joined, roles_updated, member_details_changed and left. These events are fired the same as zaikio.organization_* but the subject is the organisation and not the person.

# zaikio.member_joined

This event will be triggered every time a person was added to an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_joined",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922",
    "roles": 1 // roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.member_roles_updated

This event will be triggered every time the roles of a member changed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_roles_updated",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922",
    "roles": 1 // new roles defined as a bitfield, see: https://docs.zaikio.com/guide/oauth/client-credentials.html#on-behalf-of-person
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.member_details_changed

This event will be triggered every time a member's profile changed (such as name, language, avatar, ...)

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/memberships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.member_left

This event will be triggered every time a person was removed from an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.member_left",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "organization_membership_id": "9709f0f1-d00b-48fa-bb01-8c52bbd7296e",
    "person_id": "80ef6969-0b4d-4959-8833-875d601f0922"
  }
}

# zaikio.site_*

We offer 4 events for sites: added, details_changed, address_changed and removed.

# zaikio.site_added

This event will be triggered every time a site was added to an organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.site_details_changed

This event will be triggered every time a site name was updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_details_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.site_address_changed

This event will be triggered every time an address of a site was updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_address_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/sites/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.site_removed

This event will be triggered every time a site was removed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.site_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "site_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}

# zaikio.business_relationship_*

We offer 3 events for business relationships: added, changed and removed.

# zaikio.business_relationship_added

This event will be triggered every time a business relationship was added to an owner organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/business_relationships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.business_relationship_changed

This event will be triggered every time a business relationship name was updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/organization/business_relationships/9709f0f1-d00b-48fa-bb01-8c52bbd7296e"
}

# zaikio.business_relationship_removed

This event will be triggered every time a business relationship was removed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.business_relationship_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "business_relationship_id": "386725c0-b9b7-4d91-827f-0a4969904311",
    "target_id": "5c169904-f0fd-482e-86cf-9d9ab47faae7"
  }
}

# Vendor Events

# Connections

# zaikio.established_connection_to_vendor

This event will be triggered every time a person or organisation connected to an app of the vendor. The subject is the vendor organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.established_connection_to_vendor",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "connectable": "Org/558f9a80-5fd1-444a-8fd2-a68cf29a1b52",
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}

# zaikio.revoked_connection_to_vendor

This event will be triggered every time a person or organisation revoked a connection to an app of the vendor. The subject is the vendor organisation.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.revoked_connection_to_vendor",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "connectable": "Org/558f9a80-5fd1-444a-8fd2-a68cf29a1b52",
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}

# zaikio.app_*

We offer 3 events for apps: added, changed and removed.

# zaikio.app_added

This event will be triggered every time an app was added to a vendor organization.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_added",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/apps/386725c0-b9b7-4d91-827f-0a4969904311"
}

# zaikio.app_changed

This event will be triggered every time app details such as name were updated.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_changed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  },
  "link": "https://hub.sandbox.zaikio/api/v1/apps/386725c0-b9b7-4d91-827f-0a4969904311"
}

# zaikio.app_removed

This event will be triggered every time an app was removed.

Example event:

{
  "id": "62abcc92-e17e-4db0-b78e-13369251474b",
  "name": "zaikio.app_removed",
  "subject": "Org/2b271d51-e447-4a16-810f-5abdc596700a",
  "timestamp": "2019-11-26T10:58:09.664Z",
  "version": "1.0",
  "received_at": "2019-11-26T10:58:09.664Z",
  "payload": {
    "app_id": "386725c0-b9b7-4d91-827f-0a4969904311"
  }
}