Skip to main content
Version: v5.0

Trigger

The Trigger API allows you to list, create, update, search by ID, and delete event triggers.

Refer to the Trigger API calls below:

List triggers#

Endpoints#

GET notificationsvc/api/v1/trigger

Request#

Request body#

ParameterTypeDescriptionRequired
_nsFilterStringEvent filter to applyOptional
_countIntegerNumber of triggers to be listed. Default is 10.Required
_offset?IntegerPosition in list of triggers to begin listingRequired
_nameStringName of triggerRequired
_namespaceStringProject namespaceOptional
Request body example#

None

Response#

Codes#

CodeDescription
200Success
400Bad Request
404Not Found

Response#

{  _offset?: integer  _pageSize?: integer  _total?: integer  _list: {    _id?: string    _namespaces?: string[]    _createdAt?: string    _updatedAt?: string    _version?: integer    _name: string    _description?: string    _type: enum[EVENT]    _event: {      _filters: {      }    }    _script: {      id?: string      userType?: string      name?: string      versionId?: string    }    _senders: {      _id?: string    }[]    _templates:#/components/schemas/Ref[]    _groups:#/components/schemas/Ref[]  }[]}

Create trigger#

Endpoints#

POST notificationsvc/api/v1/trigger

Request#

Request body#

ParameterTypeDescriptionRequired
_nsFilterStringEvent filter to applyOptional
_countIntegerNumber of triggers to be listed. Default is 10.Required
_offset?IntegerPosition in list of triggers to begin listingRequired
_nameStringName of triggerRequired
_namespaceStringProject namespaceOptional
Request body example#
{  _description?: string  _type: enum[EVENT]  _event: {    _filters: {    }  }  _script: {    id?: string    userType?: string    name?: string    versionId?: string  }  _senders: {    _id?: string  }[]  _templates:#/components/schemas/Ref[]  _groups:#/components/schemas/Ref[]  _namespaces?: string[]  _name: string}

Response#

Codes#

CodeDescription
200Success
400Bad Request
404Not Found

Response#

{  _id?: string  _namespaces?: string[]  _createdAt?: string  _updatedAt?: string  _version?: integer  _name: string  _description?: string  _type: enum[EVENT]  _event: {    _filters: {    }  }  _script: {    id?: string    userType?: string    name?: string    versionId?: string  }  _senders: {    _id?: string  }[]  _templates:#/components/schemas/Ref[]  _groups:#/components/schemas/Ref[]}

Get trigger by ID#

Endpoints#

GET notificationsvc/api/v1/trigger/{id}

Request#

Request body#

ParameterTypeDescriptionRequired
_nsFilterStringEvent filter to applyOptional
_idStringID to search for
Request body example#

None

Response#

Codes#

CodeDescription
200Success
400Bad Request
404Not Found

Response#

{  _id?: string  _namespaces?: string[]  _createdAt?: string  _updatedAt?: string  _version?: integer  _name: string  _description?: string  _type: enum[EVENT]  _event: {    _filters: {    }  }  _script: {    id?: string    userType?: string    name?: string    versionId?: string  }  _senders: {    _id?: string  }[]  _templates:#/components/schemas/Ref[]  _groups:#/components/schemas/Ref[]}

Delete trigger by ID

Endpoints#

DELETE notificationsvc/api/v1/trigger/{id}

Request#

Request body#

ParameterTypeDescriptionRequired
_nsFilterStringEvent filter to applyOptional
_versionStringVersion to apply
Request body example#


Response#

Codes#

CodeDescription
200Success
400Bad Request
404Not Found

Response#