Set Connector Slot

PUT

network

connectors

{linkedinId}

slot

curl -X PUT "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X DELETE "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.put(
    "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot", {
  method: "PUT",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "linkedin_id": "nicdelaye",
    "in_slot": true,
    "used": 12,
    "limit": 25
  }
}

{
  "success": false,
  "error": {
    "message": "No connector found with linkedin id: nicdelaye",
    "code": "NOT_FOUND"
  }
}

{
  "success": false,
  "error": {
    "message": "All 25 connector slots are in use",
    "code": "CONFLICT"
  }
}

{
  "success": false,
  "error": {
    "message": "Connector slots are not in your plan",
    "code": "FORBIDDEN"
  }
}

Put a connector already in your network into one of your connector slots. Connectors in a slot are re-ingested automatically by the connector-refresh automation, on its schedule, so their book stays current without anyone re-running the import.

A slot is a promise to spend. Every scheduled refresh imports each connector in a slot again, and an import spends credits per connector. Your plan bounds how many slots you have (limit in the answer); a workspace with no slots gets 403, a full roster gets 409.

Nothing happens at the moment you set the slot: no job starts, no credits are spent. The next fire of the schedule, or Run Connector Refresh, does the work. in_slot on List Connectors shows who is in one.

Path Parameters

string

required

The connector’s LinkedIn public identifier, as returned in linkedin_id by List Connectors. For https://www.linkedin.com/in/nicdelaye that is nicdelaye.

Response Fields

string

The connector you placed.

boolean

true after a PUT, false after a DELETE.

integer

Slots taken, this one included.

integer

Slots your plan allows.

Releasing a slot

DELETE on the same path takes the connector out. They stay in the network with every opportunity they have; only the automatic refresh stops. Idempotent, like the PUT.

curl -X PUT "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X DELETE "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.put(
    "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot", {
  method: "PUT",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "linkedin_id": "nicdelaye",
    "in_slot": true,
    "used": 12,
    "limit": 25
  }
}

{
  "success": false,
  "error": {
    "message": "No connector found with linkedin id: nicdelaye",
    "code": "NOT_FOUND"
  }
}

{
  "success": false,
  "error": {
    "message": "All 25 connector slots are in use",
    "code": "CONFLICT"
  }
}

{
  "success": false,
  "error": {
    "message": "Connector slots are not in your plan",
    "code": "FORBIDDEN"
  }
}

curl -X PUT "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X DELETE "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

requests.put(
    "https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

await fetch("https://api.clustr-ai.com/api/public/network/connectors/nicdelaye/slot", {
  method: "PUT",
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});

{
  "success": true,
  "data": {
    "linkedin_id": "nicdelaye",
    "in_slot": true,
    "used": 12,
    "limit": 25
  }
}

{
  "success": false,
  "error": {
    "message": "No connector found with linkedin id: nicdelaye",
    "code": "NOT_FOUND"
  }
}

{
  "success": false,
  "error": {
    "message": "All 25 connector slots are in use",
    "code": "CONFLICT"
  }
}

{
  "success": false,
  "error": {
    "message": "Connector slots are not in your plan",
    "code": "FORBIDDEN"
  }
}

API Reference

Import

Search

Jobs

Network

Opportunities

Owners

Accounts

Account States

Saved Views

Workflows

Intro Requests

Record Activity

Lists

Tags

Account Tags

Target Accounts

Client Companies

ICP

Competitor Monitoring

Connector Refresh

Notifications

Set Connector Slot

Path Parameters

Response Fields

Releasing a slot

​Path Parameters

​Response Fields

​Releasing a slot

Path Parameters

Response Fields

Releasing a slot