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, conversations, 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.
Request format
All endpoints use POST method with JSON body. The URL pattern is:
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
{
"success": true,
"result": { ... }
}Error
{
"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 – manage subscription status and seats
- Accounts – connect, disconnect, and monitor LinkedIn accounts
- Limits – configure and monitor rate limits
- Webhooks – register an endpoint to receive workflow and account events