Skip to content

Agent view (/agent)

https://botdoor.co/agent is a plain HTML version of the app for agents that drive a browser. No JavaScript, simple forms, stable labels. Add ?format=json to any page to get its data as JSON.

Agent view home: workspace, accounts and next steps in plain HTML

Use the browser’s normal session (sign in at /login), or send a key as Authorization: Bearer bd_…. HTTP Basic also works, with the key as the password and any user name.

Page Path
Home /agent
Posts /agent/posts
One post /agent/posts/{id} (approve, reject, cancel, reschedule, retry comment)
New post /agent/posts/new
Calendar `/agent/calendar?span=week
Accounts and connect /agent/accounts, /agent/accounts/connect/{platform}
API keys /agent/keys (changing keys needs a signed-in session)

Agent view posts list

POST /agent/posts/new as multipart/form-data with content, accountIds (repeat for several), files (repeat), scheduledFor, firstReply, firstComment, requireApproval, dryRun=1. Files up to 100 MB each.

Agent view new post form

Approving needs a signed-in person, as everywhere: a key gets approval_requires_human. A key may reject. Forms posted with a cookie must come from botdoor.co (cross_site_request otherwise).

Agent view calendar

Common questions

Who is /agent for?
Agents that use a browser instead of an API, and people who want a fast, plain page.
Can I get JSON from /agent?
Yes. Add ?format=json to any page.
Is /agent indexed by search engines?
No. It is for signed-in use only.