campaigns

Submit campaign item review decisions

Changed on

Submits one or more review decisions for campaign item reviews assigned to the authenticated user. Mirrors the GraphQL reviewCampaignItems mutation.

Each decision targets a campaign_item_review_id that must belong to this campaign and be assigned to the caller. Supported decisions are APPROVED, REVOKED, CHANGE_ROLE, and REASSIGNED.

For CHANGE_ROLE, access_level_remote_id is required. For REASSIGNED, either supply new_reviewer_user_ids (manual) or an assignment_source preset (PRINCIPAL_MANAGER / ASSET_ADMIN_OWNER). Reassignment also requires the campaign configuration flag allow_reviewer_reassignment to be enabled.

When the campaign uses revoke_on: ACTION, REVOKED decisions revoke access immediately.

post/campaigns/{campaign_id}/reviews

Request

  • Base URL
    https://api.opal.dev/v1
  • Auth
    HTTP bearer

Path parameters

campaign_idstring uuid required

The ID of the campaign.

Request body

Example request

{
  "decisions": [
    {
      "campaign_item_review_id": "4b8f2c1a-9d3e-4f6a-8b1c-2e5d7a9f0c3b",
      "decision": "APPROVED",
      "note": "Access is still required for on-call.",
      "access_level_remote_id": "arn:aws:iam::123456789012:role/ReadOnly",
      "assignment_source": "MANUAL"
    }
  ]
}

Response

The updated campaign item reviews.

Example response

{
  "reviews": [
    {
      "campaign_item_review_id": "4b8f2c1a-9d3e-4f6a-8b1c-2e5d7a9f0c3b",
      "decision": "APPROVED"
    }
  ]
}

Changes

    • warning

      added the new REDUCE_EXPIRATION enum value to the ////// response property for the response status

    • info

      added the new REDUCE_EXPIRATION enum value to the request property //

    • info

      endpoint added