Agents

Agent keys and permission scopes

Give every agent its own key, limited to the networks and actions it needs. Keys are stored as hashes and can be revoked without touching other agents.

How to do it

  1. Create the agent Open Agents and add one per tool or job, for example a changelog agent and a newsletter agent.
  2. Mint a key Mint a key for that agent. Copy it immediately; it is shown once and stored only as a SHA-256 hash.
  3. Choose networks Tick only the networks this agent should draft for. A draft aimed elsewhere is refused.
  4. Choose permissions Draft is the default. Add schedule only if the agent should pick times, and analytics only if it should read metrics.
  5. Revoke when done Revoke a key the moment a tool is retired or the key may have leaked. Other agents keep working.

Permission bits

PermissionLets the agent
DraftCreate pending posts that wait in the inbox
SchedulePropose a date, time, and timezone for a post
AnalyticsRead per-post metrics and insights

Networks are a separate set of bits. A key with draft on Bluesky only cannot draft for X.

The rule that cannot be switched off

An agent key can never approve a post it drafted, even if its permissions include approve. The API answers 403. Approval comes from a person in the inbox, or from the owner key.

Owner key versus agent keys

The owner key signs in to the web app and can approve, reject, apply policy, and change brand memory. Keep it in a password manager and never put it in an agent's config. Agent keys cannot sign in to the web app.

Daily limits apply to agents

Per-account daily limits are enforced whenever no person is in the loop. A direct agent schedule that would exceed the limit fails with a 422. An owner approving by hand may go over it.

Least privilege

Start every agent at draft only. Promote it through the trust ladder when it has earned it. The least privilege glossary entry explains the principle.

Frequently asked questions

How many agent keys can I create?
The hosted Starter plan includes 2 agents, Pro 5, and Agency 25. Self-hosting has no limit.
Can two agents share a key?
They can, but you lose the audit trail of which agent wrote what and cannot revoke one without the other. Give each agent its own key.
Where do I see which key drafted a post?
Every post shows its agent in the inbox, and the audit log records the key's agent on every action.

Let your agents post. Keep the final say.

Connect your first agent in minutes. Every draft waits in your inbox until you approve it.

14 days free. No card required.

The hosted version is opening soon

Leave your email and we will send one message when hosted accounts open, with your 14-day trial ready. Want it today? Self-host it free from the repo.

Start free trial