# Overview

Admin endpoints let you programmatically manage your Linked API subscription status, seats, connected LinkedIn accounts, and rate limits.

While the main API endpoints ([workflows](/docs/executing-workflows), [conversations](/docs/working-with-conversations), [statistics](/docs/checking-api-usage-statistics)) operate on behalf of a specific LinkedIn account, admin endpoints manage your Linked API account itself. They are synchronous (direct request-response, no workflows) and require only the `linked-api-token` header – no `identification-token` is needed.

## Authentication

Admin endpoints require the `linked-api-token` header – the same token used for all other API requests. Account-specific operations accept `accountId` in the request body instead of the `identification-token` header. You can find your token in the [platform dashboard](https://app.linkedapi.io).

## Request format

All endpoints use **POST** method with JSON body. The URL pattern is:

```text
POST https://api.linkedapi.io/admin/<resource>.<action>
```

| Header | Required | Description |
|--------|----------|-------------|
| `linked-api-token` | Yes | Your Linked API token |
| `Content-Type` | Yes | `application/json` |

## Response format

### Success

```json
{
  "success": true,
  "result": { ... }
}
```

### Error

```json
{
  "success": false,
  "error": {
    "type": "errorType",
    "message": "Human-readable error description"
  }
}
```

### Common errors

| Type | HTTP Status | Description |
|------|-------------|-------------|
| `linkedApiTokenRequired` | 401 | Missing `linked-api-token` header |
| `invalidLinkedApiToken` | 401 | Token is invalid or expired |
| `accountIdRequired` | 401 | Missing or invalid `accountId` |
| `accountNotFound` | 401 | Account does not exist or does not belong to you |
| `sessionNotFound` | 404 | Connection session not found |
| `tooManyRequests` | 429 | Rate limit exceeded (100 requests per 60 seconds) |

## Next steps

- [Subscription](/docs/admin-subscription) – manage subscription status and seats
- [Accounts](/docs/admin-accounts) – list, refresh, disconnect, and monitor LinkedIn accounts
- [Connection Sessions](/docs/admin-connection-sessions) – connect and reconnect accounts, and customize the completion screen
- [Limits](/docs/admin-limits) – configure and monitor rate limits
- [Webhooks](/docs/admin-webhooks) – register an endpoint to receive workflow and account events