events

subscribe

Subscribe to a topic

Subscribe an application endpoint to be invoked when events are delivered to the targeted topic. The endpoint is described in the request body and may be either a service endpoint or an actor method.

post/event/{topic}/subscribe

Path parameters

topicstring required

The topic name

pathstring required

The target endpoint to be invoked by the operation

Request body

actorIdstring

The subscribing actor instance id

actorTypestring

The subscribing actor type

idstring

A optional unique id to use for this subscrition. If not id is provided, the topic will be used as the id.

oldestboolean

Should the subscription start with the oldest available event or only include events published after the subscription operation?

pathstring required

The target endpoint to which events will be delivered

servicestring

The subscribing service name

Example request

{
  "path": "an/arbitrary/valid/pathSegment"
}

Response

A success message.

Changes