Approvals API

Endpoints for managing content approval workflow.

Authentication

All endpoints require JWT authentication.

---

List Pending Approvals

GET /api/approvals

List content pending review.

Query Parameters

Parameter	Type	Description
status	string	Filter: pending, approved, rejected
limit	number	Results per page
offset	number	Pagination offset

Response

[
  {
    "id": "post_123",
    "type": "social",
    "content": "Post content...",
    "platform": "twitter",
    "submittedAt": "2025-01-01T10:00:00Z",
    "submittedBy": {
      "id": "user_123",
      "name": "John Doe"
    }
  }
]

---

Get Approval Item

GET /api/approvals/:id

Get details of a single approval item.

---

Approve Content

POST /api/approvals/:id/approve

Approve content for publishing.

Request Body (optional)

{
  "notes": "Looks good!"
}

Response

{
  "id": "post_123",
  "status": "approved",
  "reviewedAt": "2025-01-01T12:00:00Z",
  "reviewedBy": "user_456"
}

---

Reject Content

POST /api/approvals/:id/reject

Reject content with feedback.

Request Body

{
  "reason": "Please review the hashtags",
  "notes": "The hashtag #xyz is not appropriate for this campaign"
}

---

Request Changes

POST /api/approvals/:id/request-changes

Request revisions before approval.

Request Body

{
  "feedback": "Please shorten the content for Twitter's character limit"
}

---

Permissions

• Requires content:approve permission
• Users can submit their own drafts
• Cannot approve your own content