Skip to content

Batch Approve Sections

POST
/api/canvas/{deal_id}/sections/batch-approve
curl --request POST \
--url https://example.com/api/canvas/example/sections/batch-approve \
--header 'Authorization: Bearer <token>'

Approve all sections currently in ‘reviewed’ state.

This is a convenience endpoint for one-click approval of all reviewed sections, typically invoked from the FinalizeBar’s “Approve All” button.

Args: deal_id: Deal identifier request: FastAPI request (used for broadcast helpers) user: Authenticated user from JWT canvas_service: Canvas service instance

Returns: BatchApproveResponse with per-section results

Raises: HTTPException: 403 if user doesn’t have access to deal

deal_id
required
Deal Id
string

Successful Response

Media type application/json
BatchApproveResponse

Response for batch approve operation.

object
results
required
Results
Array<object>
BatchSectionResult

Result for a single section in a batch operation.

object
section_key
required
Section Key
string
success
required
Success
boolean
error
Any of:
string
all_success
required
All Success
boolean
approved_count
required
Approved Count
integer
Example generated
{
"results": [
{
"section_key": "example",
"success": true,
"error": "example"
}
],
"all_success": true,
"approved_count": 1
}

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Example generated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}