Goal
Add a review comment to a draft without approving or rejecting it. Used for suggestions, questions, or notes during review process.
Which Agents Use This
- reviewer — Add suggestions before approval, ask questions, note observations
- custom — Any agent participating in review process
- Humans can also add comments during review
Hard Rules
- MUST attach comment to post
- SHOULD specify comment_type for context (suggestion, question, note, praise)
- SHOULD be specific and actionable
- Comments don't change post status (still in review)
Steps
1. Validate input
- Verify post_id exists
- Verify comment is non-empty
- Validate comment_type if provided
2. Create comment
- Attach comment to post
- Record comment_type
- Record author (agent or human)
- Timestamp comment
3. Return confirmation
- Return comment_id and success message
Output
{
"success": true,
"comment_id": "uuid",
"message": "Comment added to post."
}
Failure Handling
- If post_id not found: return error "Post not found"
- If comment empty: return error "Comment text required"
Example Usage
Scenario 1: Reviewer adding suggestion
{
"post_id": "uuid",
"comment": "Consider changing 'utilize' to 'use' (voice profile prefers simpler words)",
"comment_type": "suggestion"
}
Result: Comment added to draft for creator to review
Scenario 2: Reviewer asking question
{
"post_id": "uuid",
"comment": "Is this stat current? I see different numbers in our latest report.",
"comment_type": "question"
}
Result: Question flagged for creator or human to answer before approval
1---2name: bolta-add-comment3version: 2.0.04description: Add a review comment to a draft without approving or rejecting - used for suggestions, questions, or notes5category: review6roles_allowed: [Viewer, Creator, Editor, Admin]7required_scopes: [posts:write]8agent_types: [reviewer, custom]9safe_defaults: {}10tools_required: []11inputs_schema:12 type: object13 required: [post_id, comment]14 properties:15 post_id: { type: string, description: "Draft post UUID" }16 comment: { type: string, description: "Comment text" }17 comment_type: { type: string, enum: [suggestion, question, note, praise], default: note }18outputs_schema:19 type: object20 properties:21 success: { type: boolean }22 comment_id: { type: string }23 message: { type: string }24organization: bolta.ai25author: Bolta Team26---2728## Goal29Add a review comment to a draft without approving or rejecting it. Used for suggestions, questions, or notes during review process.3031## Which Agents Use This32- **reviewer** — Add suggestions before approval, ask questions, note observations33- **custom** — Any agent participating in review process34- Humans can also add comments during review3536## Hard Rules371. MUST attach comment to post382. SHOULD specify comment_type for context (suggestion, question, note, praise)393. SHOULD be specific and actionable404. Comments don't change post status (still in review)4142## Steps4344### 1. Validate input45- Verify post_id exists46- Verify comment is non-empty47- Validate comment_type if provided4849### 2. Create comment50- Attach comment to post51- Record comment_type52- Record author (agent or human)53- Timestamp comment5455### 3. Return confirmation56- Return comment_id and success message5758## Output59```json60{61 "success": true,62 "comment_id": "uuid",63 "message": "Comment added to post."64}65```6667## Failure Handling68- If post_id not found: return error "Post not found"69- If comment empty: return error "Comment text required"7071## Example Usage7273### Scenario 1: Reviewer adding suggestion74```json75{76 "post_id": "uuid",77 "comment": "Consider changing 'utilize' to 'use' (voice profile prefers simpler words)",78 "comment_type": "suggestion"79}80```81**Result:** Comment added to draft for creator to review8283### Scenario 2: Reviewer asking question84```json85{86 "post_id": "uuid",87 "comment": "Is this stat current? I see different numbers in our latest report.",88 "comment_type": "question"89}90```91**Result:** Question flagged for creator or human to answer before approval
boltaai