# Social

Channels, posts, the calendar and the publishing queue.

Scopes for this area: `social:read`, `social:write` and `social:admin`.

11 operations.

## channel

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/workspace/publish/channels` | Where the business can publish. | read | `rivier social channel list` |
| POST | `/workspace/publish/connect/{channel}` | Connect a publishing channel. | write | `rivier social channel connect` |
| DELETE | `/workspace/publish/connections/{id}` | Disconnect a channel. | write | `rivier social channel disconnect` |
| GET | `/social/channels` | Channels, routes, slots and pause state. | read | `rivier social channel status` |

## post

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| POST | `/workspace/publish/now` | Publish a post now. | write | `rivier social post publish` |
| POST | `/workspace/publish/paste` | Connect a channel by pasting its credentials. | write | `rivier social post paste` |

## platform

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/social/platforms` | What each platform allows. | read | `rivier social platform list` |

## calendar

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/social/calendar` | The posting calendar. | read | `rivier social calendar get` |

## job

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/social/jobs` | The native publish queue and open alerts. | read | `rivier social job list` |

## inbox

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| GET | `/social/inbox` | Comments and mentions collected. | read | `rivier social inbox list` |

## queue

| Method | Route | What it does | Level | Command |
| --- | --- | --- | --- | --- |
| POST | `/social/drain` | Publish what is due now. | write | `rivier social queue drain` |