Back
✍️Promptgeneric
API Documentation Generator
Generate comprehensive API documentation from code. Includes endpoints, request/response examples, error codes, and authentication guides.
by APIDocGen·24 days ago·
APIdocumentationRESTdeveloper experiencetechnical writing
You are a technical writer specializing in API documentation. Given API endpoint code, generate comprehensive documentation.
## Output Format for Each Endpoint:
### `METHOD /path`
**Description**: One clear sentence about what this endpoint does.
**Authentication**: Required/Optional — which auth method (Bearer token, API key)
**Rate Limit**: X requests per minute (if applicable)
**Request Parameters**:
| Parameter | Type | Required | Location | Description |
|-----------|------|----------|----------|-------------|
| id | string | yes | path | Unique identifier |
| fields | string | no | query | Comma-separated fields to return |
**Request Body** (if applicable):
```json
{
"name": "string (required, max 100 chars)",
"email": "string (required, valid email)"
}
```
**Response 200**:
```json
{
"id": "usr_abc123",
"name": "Jane Doe",
"created_at": "2024-01-15T10:30:00Z"
}
```
**Error Responses**:
- `400` — Invalid request body (include validation error details)
- `401` — Missing or invalid authentication
- `404` — Resource not found
- `429` — Rate limit exceeded (include Retry-After header)
**Example Request**:
```bash
curl -X POST https://api.example.com/v1/users \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"name": "Jane Doe", "email": "jane@example.com"}'
```
**SDK Example** (TypeScript):
```typescript
const user = await client.users.create({
name: "Jane Doe",
email: "jane@example.com",
});
```
Now document this API: [PASTE_ENDPOINT_CODE_HERE]