Skip to main content
POST
/
memos
/
{id}
/
reject
curl -X POST https://api.companyflow.com/memos/550e8400-e29b-41d4-a716-446655440000/reject \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "comments": "Policy conflicts with existing HR guidelines. Please revise section 3."
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "company_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_by": "987e6543-e21b-12d3-a456-426614174000",
    "memo_type": "policy",
    "title": "Updated Remote Work Policy",
    "content": "Effective immediately, all employees are eligible for hybrid work arrangements...",
    "reference_number": "MEMO-2025-001",
    "priority": "high",
    "status": "rejected",
    "current_step": 1,
    "rejected_by": "abc12345-e89b-12d3-a456-426614174000",
    "rejected_at": "2025-03-03T15:30:00Z",
    "rejection_reason": "Policy conflicts with existing HR guidelines. Please revise section 3.",
    "created_at": "2025-03-03T10:00:00Z",
    "updated_at": "2025-03-03T15:30:00Z"
  }
}
Reject a memo at its current workflow approval step. This stops the approval process and marks the memo as rejected, requiring the creator to either revise and resubmit or cancel the memo.

​
Authentication

Requires authentication with Bearer token. Available to:
  • Manager
  • HR Manager
  • Super Admin
Only users with approval authority at the current workflow step can reject the memo. Rejecting a memo is a significant action that stops the approval workflow.

​
Path Parameters

​
id
string
required
The unique identifier of the memo (UUID format)Example: "550e8400-e29b-41d4-a716-446655440000"

​
Request Body

​
comments
string
Optional rejection comments explaining the reason for rejectionExample: "Policy conflicts with existing HR guidelines. Please revise section 3."

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The updated memo object with rejected status
curl -X POST https://api.companyflow.com/memos/550e8400-e29b-41d4-a716-446655440000/reject \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "comments": "Policy conflicts with existing HR guidelines. Please revise section 3."
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "company_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_by": "987e6543-e21b-12d3-a456-426614174000",
    "memo_type": "policy",
    "title": "Updated Remote Work Policy",
    "content": "Effective immediately, all employees are eligible for hybrid work arrangements...",
    "reference_number": "MEMO-2025-001",
    "priority": "high",
    "status": "rejected",
    "current_step": 1,
    "rejected_by": "abc12345-e89b-12d3-a456-426614174000",
    "rejected_at": "2025-03-03T15:30:00Z",
    "rejection_reason": "Policy conflicts with existing HR guidelines. Please revise section 3.",
    "created_at": "2025-03-03T10:00:00Z",
    "updated_at": "2025-03-03T15:30:00Z"
  }
}

​
What Happens After Rejection

1

Workflow Stops

The memo approval workflow is immediately halted
2

Creator Notified

The memo creator receives a notification with rejection details and comments
3

Status Updated

Memo status changes to rejected and is no longer in the approval queue
4

Next Actions

The creator can revise the memo based on feedback and create a new version, or cancel the memo entirely

​
Best Practices

Providing helpful feedback:
  • Always include detailed comments explaining the reason for rejection
  • Reference specific sections or issues that need to be addressed
  • Suggest concrete improvements or alternatives
  • Be constructive to help the creator revise effectively
If the memo needs minor changes, consider communicating directly with the creator before rejecting. Rejection should be reserved for significant issues that require substantial revision.

​
Authorization Rules

Similar to approval, rejection requires:
  • The memo must be at a workflow step where you have approval authority
  • Managers can reject memos from their department or direct reports
  • HR Managers and Super Admins can reject any memo
  • The memo must be in pending status (not already approved or rejected)

Build docs developers (and LLMs) love

Get started for freeTalk to us