Decisions

Give feedback on a Decision

Tells OneLence whether a source's current Decision was useful, already acted on, not relevant or based on wrong data. Pass the posture the Decision showed; if it changed since, read it again first.

post/sites/{site}/decisions/{source_id}/feedback

Request

  • Base URL: https://api.onelence.com/v1
  • URL: https://api.onelence.com/v1/sites/{site}/decisions/{source_id}/feedback
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://api.onelence.com/oauth/authorize, token URL https://api.onelence.com/oauth/token, scopes: workspace:write)
    • HTTP bearer

Path parameters

sitestring required

Site domain (e.g. example.com) or site id. Defaults to the workspace's newest active site.

source_idstring required

source.id of the Decision.

Query parameters

dry_runboolean

true returns a preview of the change and applies nothing.

Headers

Idempotency-Keystring

8 to 200 visible ASCII characters. Retries with the same key and request return the stored response for 24 hours.

Request body

decision'scale' | 'hold' | 'stop' required

The posture the Decision showed.

feedback'useful' | 'already_acted' | 'not_relevant' | 'data_wrong' required
notestring
startstring

Window start: a date (YYYY-MM-DD) or ISO 8601 date-time. Defaults to 30 days before end.

endstring

Window end, inclusive for a date. Defaults to now.

Response

Success.

object'decision_feedback' required
source_idstring required
decision'scale' | 'hold' | 'stop' required
feedback'useful' | 'already_acted' | 'not_relevant' | 'data_wrong' required
status'created' | 'updated' | 'unchanged' required
recorded_atstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.