# Agent view (/agent)

> Botdoor's plain-HTML agent view at /agent for browser-using agents: pages, forms, JSON mode and authentication.

Source: https://docs.botdoor.co/agent-view/overview/

`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](https://docs.botdoor.co/screenshots/agent-home.png)

## Signing in

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.

## Pages

| 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|month` |
| Accounts and connect | `/agent/accounts`, `/agent/accounts/connect/{platform}` |
| API keys | `/agent/keys` (changing keys needs a signed-in session) |

![Agent view posts list](https://docs.botdoor.co/screenshots/agent-posts.png)

## New post form

`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](https://docs.botdoor.co/screenshots/agent-new-post.png)

## Approvals

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](https://docs.botdoor.co/screenshots/agent-calendar.png)

## 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.
