Skip to main content
Signal agents are always-on discovery setups created in the dashboard. The agent name describes the Plyne product surface, while sheet_id and sheet_name identify the sheet where that agent is configured. 
curl --request POST \
  --url https://api.plyne.ai/v1/signals/agents \
  --header 'Authorization: Bearer plyne_...' \
  --header 'Content-Type: application/json' \
  --data '{
    "cursor": { "limit": 50 }
  }'

{
  "data": [
    {
      "id": "d8m13il8samas88tvoq0",
      "name": "Intent Signals",
      "status": "active",
      "schedule": "4x daily",
      "next_check_at": "2026-06-17T02:03:00Z",
      "leads_count": 84,
      "sheet_id": "d8m13il8samas88tvop0",
      "sheet_name": "AI infrastructure buyers"
    },
    {
      "id": "d8cln7t8sam5q17hnr9g",
      "name": "Intent Signals",
      "status": "paused",
      "schedule": "4x daily",
      "leads_count": 36,
      "sheet_id": "d8cln7t8sam5q17hnr8g",
      "sheet_name": "FinOps hiring signals"
    }
  ],
  "cursor": {
    "next": "",
    "has_more": false
  }
}

POST /v1/signals/agents

​
Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your API key.

​
Body

cursor.limitinteger

Number of signal agents to return. Maximum value is 100.

Example: 50

cursor.afterstring

Opaque cursor returned as cursor.next from the previous response.

statusesstring[]

Filter by agent status, such as active or paused.

Use POST /v1/signals/leads with sheet_ids and signals to read leads from a specific sheet or buying signal.