alpha

Retry advisor reviews

Deprecated: use alpha.advisor-reviews.run.v1 (alpha_advisor_reviews_run), which runs Advisor whenever it is asked. This version runs the organization's Advisor review again (id "organization") only after it failed: admitted runs one new free review, whose runId platform.runs.get follows. Otherwise it answers where the review stands: running (one runs now, its runId), current (the newest review published, its runId), waiting (the newest found the list changed while it ran; the review it owes runs shortly), nothing_to_review (no review has run yet), or refused (with Billing's reason). A review no longer waits for campaigns' measurements, so waiting never means one is still settling.

post/api/v1/alpha/advisor-reviews/retry

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/alpha/advisor-reviews/retry
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Idempotency-Keystring uuid required

UUID naming this intent. Retry with the same key; reuse for other input is 409.

Request body

id'organization' required

"organization", Advisor's one org-wide review

Response

Success.

id'organization' required

"organization", Advisor's one org-wide review

state'admitted' | 'running' | 'current' | 'nothing_to_review' | 'waiting' | 'refused' required

admitted: a new review started. running: one is already running. current: the newest review published. waiting: the newest found the list changed while it ran, and the review it owes runs shortly. nothing_to_review: no review has run yet. refused: it could not start now

runIdstring uuid nullable required

The review run admitted, running or current; null otherwise

reasonstring nullable required

Why it could not start, when refused (Billing's admission refusal); null otherwise

Changes

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