Glossary
OpenQuok terms in one place — workspace, channel, smart filters, templates, tags, building blocks, playbooks, plugs, and how agents fit the review flow.
Connect your agent today
Draft from chat, review in your calendar, and publish only what you approve.
These are the words the Guide, app, public API, and CLI use for the same things. Read this once; later pages assume you know them.
Workspace
A workspace is the top-level boundary you own for your data: channels, posts, media, tags, templates, teammates, and settings. You can belong to several; the header switcher loads another workspace’s data when you change.
The first registrant owns the workspace. Teammates join through Settings → Workspace. See Team.
The public API calls the same object an organization. Cloud billing is one subscription per workspace. Plan limits are on Pricing and Cloud limits.
Channel
A channel is one connected social account — one X profile, one LinkedIn Page, one Threads account. Connecting the same network twice creates two channels.
Channel vs integration
The app says channel. The public API and the CLI say integration. They are the same object. Anywhere the API asks for an integration id, it wants the UUID of a channel.
Channel groups
A channel group bundles channels — usually one client or brand. Groups filter Home and the calendar, and let you pick that bundle in the post editor. The Channel groups dropdown on those boards is part of the smart filter. See Channel groups for how to create groups, filter the board, and select a whole client in the composer.
The public API names the same concept customers. See Channel groups API.
Post and post group
Scheduling one caption to five channels creates five posts tied to one post group. Home kanban cards usually represent the group; opening a card shows each channel row.
A single post can hold multiple parts — a thread on X or Threads, or timed follow-up replies where the network allows. See Threads and comments.
Global vs per-channel
Global mode keeps one caption synced across every channel you selected. Click a channel avatar to focus it — the composer shows Editing a Specific Network.
The editor stays locked until you click Edit content. That exits global mode for that channel so you can change its caption and provider settings without touching the others. ← Back to global returns to the shared draft. Mentions and network-only fields belong on a customized channel. See Global vs per-channel.
The API mirrors this: one shared body with optional per-integration caption and setting overrides.
Provider settings
Each network expects extra fields beyond the caption — a YouTube title, Dev.to tags, an Instagram post type. These provider settings sit in the composer beside the preview. Some are required; the post will not save without them.
See Posting rules by platform and Links and validation for limits and save-time errors. API shapes are in Supported social channels.
Tag
A tag is a colored workspace label you attach to a post. The color tints the card on Home and the calendar so campaigns, clients, or content types stand out at a glance.
See Tags.
Template
A template is a saved preset of selected channels, caption (global or per-channel), media, provider settings, and tags. Select a template when you start a post instead of rebuilding the same setup.
Templates are created at /account/templates. See Templates.
Templates are workspace-scoped. They speed up repeat workflows; they do not auto-publish on their own.
Signature
A signature is reusable trailing text — a CTA, hashtag block, or link line. You can append it from the composer toolbar.
Manage them under Settings → Signatures. See Signatures.
Mark one signature as default and OpenQuok inserts it into new posts automatically. You can still edit or remove it per post.
Time slot
Each channel keeps time slots: the times of day you normally post. They drive the next-slot suggestion when you schedule in the editor. Check out Find slot.
Slots are a convenience, not a lock — you can always pick another time. See Posting time slots to edit them. Labels follow Timezone in Settings.
Calendar vs kanban
| Surface | Best for |
|---|---|
| Calendar (/account/calendar) | What ships by date — busy weeks, empty days, opening the composer for a slot |
| Kanban (/account Home) | Status — drafts waiting for review, scheduled items, recently published posts |
Both views read the same posts. Changing a time in the composer updates both. See Tour the app.
Smart filter
A smart filter is how you narrow a table or board to the channels, posts, templates, or plugs you are working on. Plans list this as Smart filters.
On Home, switch Connected channels to table view (the table icon), then click Add filters. You can match social platform, connected account, group name, or status.
The same Add filters control sits on the tables at Templates and Auto Plugs — for example social channel and tags on templates, or rule and active on plugs.
On the calendar and the kanban, smart filters are the dropdowns: Channel groups, platforms, and tags. The calendar also has post types. Kanban also has a date range, review status, and source (Agent or Human).
See Manage a channel, Channel groups, Templates, and Plugs.
Post states
| State | Meaning |
|---|---|
| Draft | Save as draft. On Home under Drafted posts. Never publishes until you schedule it. |
| Scheduled | Queued for its date (Add to calendar). The normal state for upcoming posts. |
| Published | Sent to the network. The card can link to the live post when the provider returns a URL. |
| Failed | The network rejected it or the channel was disconnected. The calendar card shows Failed. Open it for the error, then edit and schedule again. |
Nothing publishes until a scheduled time arrives and the row is publishable — except Publish now in the composer, which queues for the current time.
Preview link
Every post can expose a preview link. You can open the link from the post action modal on Kanban or the calendar. See Approvals for sending links to clients and collecting comments.
Share it so someone without an OpenQuok account can read the post and leave comments.
On Cloud, shareable previews require Team plan or above — see Cloud limits.
Internal plug
An internal plug is a one-time follow-up tied to a single post group — a delayed reply or a cross-channel comment after publish. Set it in the composer at Plug settings.
Today this is enabled for some networks only (for example Threads and X). The repost option needs at least two connected channels. See Plugs.
It runs once, right after that group publishes, and does not edit the original post.
Global plug
A global plug is a saved channel rule at /account/plugs that fires on future publishes when engagement crosses your threshold — for example an auto-repost or auto-reply when likes hit a target.
See Plugs. The worker re-checks on a schedule, up to three times per post.
Building block
A building block is one catalog entry you can install into an agent setup — a skill, an MCP server, or both. It ships a single capability: install steps, and docs on the Building Blocks hub.
Create and edit yours from /account/playbooks. A block is one piece of the stack; add it when you need a specific tool or instruction set, not a full workflow.
Playbook
A playbook is a curated stack of building blocks with a shared workflow. Playbooks appear on the Playbooks hub and under My Playbooks in your account.
Browse Explore to bookmark community playbooks, or publish your own when you want readers to adopt a whole routine. You can also draft one in Skill Builder.
Agents
Agents are your own external assistants — Cursor, Claude Code, CI scripts, chat hosts — that call OpenQuok through the CLI, MCP, or public API. Browse the Agents hub to tailor your harness to your use cases.
Agent-created drafts can include a review note on the kanban card. Clear or edit it before you approve.
Note
Install the openquok-core skill or connect MCP so agents know workspace tokens and integration UUIDs. Humans still move drafts to Scheduled when you want explicit approval.