Discovery

List Plans

List discovery plans owned by the calling user.

Scoping (mirrors /api/jobs):

  • With X-Kolens-User-Id (the normal web path): restrict to plans owned by that user. Both DiscoveryPlan.user_id and APIKey.user_id are honoured (older rows where user_id is NULL but the api_key resolves to a user still belong to them).
  • Without the header (CLI / Cowork plugin): legacy per-api_key.

Was previously scoped only by api_key. Every web user shares the same KOLENS_API_KEY through the Vercel proxy, so plans LEAKED across users on the listing page until this fix.

get/api/discovery-plans

Request

  • Base URL: https://api.kolens.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.kolens.ai/api/discovery-plans
  • Auth: HTTP bearer

Query parameters

status'draft' | 'active' | 'disabled' nullable

Headers

x-kolens-user-idstring nullable

Response

Successful Response

idstring required
namestring required
keywordstring required
platformstring required
interval_hoursinteger required
max_videos_per_runinteger required
regionstring nullable
filtersobject nullable required
target_list_idstring nullable required
status'draft' | 'active' | 'disabled' required
effective_status'draft' | 'active' | 'disabled' | 'queued' | 'running' | 'failed' required
data_sourcestring required
last_run_atstring nullable required
next_run_atstring nullable required
last_job_idstring nullable required
last_job_statusstring nullable
last_errorstring nullable
created_atstring required
updated_atstring required

Changes

No recorded changes to this operation across all 1 revision of this API.