KOkobaltlabs
reviews

Request Service Ira Changes

Changed on

Send a submitted IRA questionnaire back to its recipient to correct.

Reuses the same response row rather than canceling it like reassign does, so the recipient's answers survive and are pre-filled when they reopen the form — they correct what's wrong instead of starting over. Returning it to WAITING_FOR_RESPONSE is what reopens the recipient-facing write path, since /forms/response/{id} rejects saves and re-submits on a SUBMITTED response.

Only available while the IRA stage is still open. The task itself is usually already COMPLETED by then (the agent derived risk from the submission), so this reopens it: leaving it complete would both read as "Skipped" in the task list (a completed task with an unsubmitted form) and let the stage advance out from under the recipient.

post/reviews/{review_id}/service-ira/task/{task_id}/request-changes

Request

  • Base URL
    https://api.kobaltlabs.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.kobaltlabs.com/reviews/{review_id}/service-ira/task/{task_id}/request-changes
  • Auth
    none declared

Path parameters

review_idstring uuid required
task_idstring uuid required

Request body

bodystring required
due_datestring date-time required

Response

Successful Response

task_idstring uuid required
review_idstring uuid required
task_type'service_ira' | 'service_form' | 'vendor_ira' | 'evidence_packet_review' | 'evidence_review' | 'review_reporting' | 'review_metadata' required
status'pending' | 'completed' required
createdstring date-time nullable
modifiedstring date-time nullable
service_idstring uuid required
service_namestring required
starting_inherent_riskstring uuid nullable
starting_inherent_risk_labelstring nullable
suggested_inherent_riskstring uuid nullable
suggested_inherent_risk_labelstring nullable
set_inherent_riskstring uuid nullable
set_inherent_risk_labelstring nullable
inherent_risk_rationalestring nullable
starting_service_criticalitystring uuid nullable
starting_service_criticality_labelstring nullable
suggested_service_criticalitystring uuid nullable
suggested_service_criticality_labelstring nullable
set_service_criticalitystring uuid nullable
set_service_criticality_labelstring nullable
service_criticality_rationalestring nullable
form_idstring uuid nullable
form_response_idstring uuid nullable
active_form_response_idstring uuid nullable
form_status'WAITING_FOR_RESPONSE' | 'SUBMITTED' | 'CANCELED'
form_recipient_user_idstring uuid nullable
form_recipient_emailstring nullable
form_recipient_namestring nullable
due_datestring date-time nullable
overdue_last_notified_atstring date-time nullable
form_changes_requested_atstring date-time nullable
agent_run_idstring uuid nullable
agent_run_status'pending' | 'running' | 'completed' | 'failed'
run_idstring uuid nullable
run_status'archived' | 'available' | 'deleted' | 'pending' | 'failed'
answers_staleboolean
ira_template_configuredboolean

Changes

  • 9fe2fb8a3631Revision changes
    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status