Skip to main content

Remote Request Hook API (0.1.0)

A Remote Request Hook receive approvals request from Witboost such that they can be forwarded to third-party ticketing systems.

As an example, with the Remote Request Hook, you can handle Access Control requests from outside Witboost.

RemoteRequestHook

Send approval request

Receive a request from witboost about an ongoing action started by a user that requires a third-party interaction on your end

header Parameters
X-Request-ID
required
string <uuid>
Examples:
  • 6bba34a3-173e-4100-9ccb-5b63035cc86a -

A unique identifier for the request that can be used to trace the request in the logs.

Request Body schema: application/json
required

An object containing all the input data received by the action where the remote request hook is attached

respondToUrl
required
string

URL to be contacted to notify that the hook is completed. This represents the fact that the third-party interaction has been performed on your end. e.g. An access request that has been accepted on your dedicated platform

fields
required
object

A free-form object containing all the action's input data coming from witboost

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
Example
{
  • "hookInfo": {
    }
}