# Administration

Manage your Linked API subscription status, seats, connected accounts, and rate limits from the terminal.

> Admin commands use your **Linked API Token** and do not require an active account. They work even if no LinkedIn accounts are connected.

## Subscription

```bash
# Check subscription status
linkedin admin subscription status

# View current seats
linkedin admin subscription seats

# Set seats (updates existing or returns checkout link)
linkedin admin subscription set-seats --quantity 5 --type plus --period year
```

## Accounts

```bash
# List all connected accounts and pending sessions
linkedin admin accounts list

# Connect a new LinkedIn account (opens connection link)
linkedin admin accounts connect

# Create a fresh reconnection link for an account
linkedin admin accounts reconnect <accountId>

# Refresh stored profile URL, avatar, headline, and name
linkedin admin accounts reparse <accountId>

# Check connection session status
linkedin admin accounts session <sessionId>

# Cancel a pending connection session
linkedin admin accounts cancel-session <sessionId>

# Disconnect an account (irreversible)
linkedin admin accounts disconnect <accountId>

# Regenerate identification token
linkedin admin accounts regenerate-token <accountId>
```

### Connection flow

```bash
# 1. Start a connection session
linkedin admin accounts connect
# → Opens connection link, displays sessionId

# 2. User logs into LinkedIn in the opened page

# 3. Check session status (or wait for the command above to complete)
linkedin admin accounts session <sessionId> --json
# → {"status": "success"} when done

# 4. Verify the account appeared
linkedin admin accounts list
```

### Reconnection flow

```bash
# 1. Find accounts that require reconnection
linkedin admin accounts list
# → reconnection_required accounts include reconnectionLink when available

# 2. Create a fresh reconnection session if you need to replace the link
linkedin admin accounts reconnect <accountId>
# → Displays reconnectionSessionId and reconnectionLink

# 3. Open the reconnectionLink and complete LinkedIn login

# 4. Check session status
linkedin admin accounts session <reconnectionSessionId> --json
```

## Webhooks

Register an endpoint that receives [workflow and account events](/docs/webhooks), inspect recent deliveries, and verify the endpoint end-to-end. A client may hold one active webhook at a time.

```bash
# Register the webhook (fat inlines the workflow result; thin sends a reference)
linkedin admin webhook set https://example.com/hooks/linkedapi
linkedin admin webhook set https://example.com/hooks --payload-mode thin

# Show the active webhook
linkedin admin webhook get

# Switch payload mode
linkedin admin webhook set-payload-mode <webhookId> thin

# Delete the webhook (soft-delete: delivery history is kept)
linkedin admin webhook delete <webhookId>

# Inspect the most recent deliveries (debug feed, newest first)
linkedin admin webhook deliveries

# Re-arm an already-settled delivery for redelivery (reuses the same event id)
linkedin admin webhook replay <deliveryId>

# Emit a synthetic webhook.test event to verify the endpoint
linkedin admin webhook send-test
```

## Limits

```bash
# View system default limits
linkedin admin limits defaults

# View current limits for an account
linkedin admin limits get <accountId>

# View current usage against limits
linkedin admin limits usage <accountId>

# Set limits for an account
linkedin admin limits set <accountId> \
  --category stMessages --period daily --max 25

# Delete specific limits (falls back to defaults)
linkedin admin limits delete <accountId> \
  --category stMessages --period daily

# Reset all limits to defaults
linkedin admin limits reset <accountId>
```

### Limit categories

| Category | Description |
| --- | --- |
| `stPersonProfileViews` | Standard LinkedIn profile views |
| `stCompanyPageViews` | Standard LinkedIn company page views |
| `stConnectionRequests` | Connection requests sent |
| `stMessages` | Messages sent |
| `stSearchQueries` | LinkedIn search queries |
| `stReactions` | Post reactions |
| `stComments` | Post comments |
| `stPosts` | Posts created |
| `nvPersonProfileViews` | Sales Navigator profile views |
| `nvCompanyPageViews` | Sales Navigator company page views |
| `nvMessages` | Sales Navigator messages |

Periods: `daily`, `weekly`, `monthly`.

For the complete HTTP API reference, see the [Admin API docs](/docs/admin-overview).