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

Payload

Content type

application/json

{"respondToUrl": "http://my-instance.witboost.com/api/actionHandler/123456",
"fields": {"identities": ["john.doe_company.com"
],
"verb": "grant",
"motivation": "I need access to this resource",
"domain": "finance",
"role": "data_engineer"
}
}

Response samples

202
400
401
500

Content type

application/json

Example

standard

{"hookInfo": {"status": "accepted",
"message": "request has been accepted on the external system"
}
}

Remote Request Hook API (0.1.0)