# Authentication

> How to authenticate Article API requests and where to find the workspace token.

The Article API lets you generate article drafts and summaries of scientific papers from code, and check their status.

Base URL: `https://api.prosecaptain.com/api/generate`

## Token

Every request needs the workspace token in the `token` parameter:

```text
POST https://api.prosecaptain.com/api/generate/draft?token=YOUR_TOKEN
```

Find the token in the app: **Profile** → **Security** tab → **Security Credentials** card (**Show** button). It is the same token as in the widget code.

Treat the token like a password: use it on your server only, never in browser code.

## Limits

- All endpoints: 100 requests per 15 minutes per IP address.
- AI generation (drafts, summaries): 10 requests per minute.
- Maximum request size: 10 MB.
- Long operations can take up to 3 minutes. Set your client timeout to at least 180 seconds.

## Common fields

| Field | Default | Description |
|---|---|---|
| `keywords` | — | Keywords: an array or a comma-separated string. |
| `toneOfVoice` | `professional` | Writing style, e.g. `professional`, `casual`, `formal`. |
| `complexity` | `moderate` | Reading level: `simple`, `moderate`, `complex`, or a number (fog index). |
| `language` | `english` | `polish`/`pl`, `english`/`en`, `german`/`de`, `french`/`fr`. |
| `contentType` | `blogpost` | Content type. |