Lists
12 operations. Each REST operation is also an MCP tool of the same name. REST https://tlntconnect.com/api/v1
GET/api/v1/lists
Every agency creator list of the workspace, as every staff member sees them in the app: id, name, description, color, creator_count, share_enabled, created_at, updated_at. Sorted by updated_at (newest first); paged with page/limit (limit ≤ 100, default 50).
list_listslists:read- admin, manager, scout, viewer
- Ignored (read)
- 1
Input
limit queryinteger — Page size, default 50.page queryinteger — 1-based page, default 1.q querystring — Name search.Responses
POST/api/v1/lists
Creates an agency creator list through the canonical helper (createListFromInput — the same validation as the app: a name of 1-120 characters, every creator an ACTIVE roster creator of this workspace or 400). quoted_rates sets an integer-cent quote per selected creator and needs an admin member AND finance:read (403 otherwise). Returns 201 with the list.
create_listlists:write- admin, manager
- optional
- 1
Input
Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.color bodystring — #rrggbbcreator_ids bodyarray of string (uuid) — Active roster creators to add, in list order.description bodystring | nullname body, requiredstringquoted_rates bodyarray of object — Quoted rate (integer cents) per selected creator. Admin members with finance:read only.Responses
GET/api/v1/lists/{list_id}
One agency creator list (members via GET /lists/{id}/members). Unknown, cross-workspace or archived ids return 404.
get_listlists:read- admin, manager, scout, viewer
- Ignored (read)
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.Responses
PATCH/api/v1/lists/{list_id}
Partial update through the canonical helper (updateListFromInput, the same versioned RPC as the app). expected_updated_at (the updated_at from GET /lists/{id}) is required: missing is 428 expected_updated_at_required, a list changed since is 409 stale_target and nothing is written. A shared list's public page refreshes.
update_listlists:write- admin, manager
- optional
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.color bodystring — #rrggbbdescription bodystring | nullexpected_updated_at bodystring — The record's updated_at as you last read it (ISO 8601). Required on updates: a missing one is 428 expected_updated_at_required, an older one 409 stale_target.name bodystringResponses
DELETE/api/v1/lists/{list_id}
Deletes one creator list in this workspace (its members stay on the roster). A `delete`-class action: by default it deletes at once and answers 200 { status: "deleted" }, within the credential's daily delete cap (429 daily_delete_cap_reached past it). When the credential asks for approval in TLNT for deletes, the call answers 202 { status: "pending_approval", action_id, approval_url } instead and a workspace admin or manager approves or rejects it in TLNT; poll GET /actions/{action_id}. The approver is shown the list as it was when you asked: a list edited before approval is not deleted. Requires the lists:read and delete scopes, an Idempotency-Key, and an admin or manager member.
delete_listlists:read+delete- admin, manager
- Runs directly; queued when the credential asks for approval for delete
- required
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.expected_updated_at querystring — The list's updated_at as you last read it. Optional: when given, a list changed since then is refused (409 stale_target). In a query string, URL-encode it (+ as %2B).Idempotency-Key header, requiredstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.Responses
GET/api/v1/lists/{list_id}/members
Members of one list in their manual order: creator_id, position, added_at and creator {id, display_name, primary_platform, total_reach, former_at}. quoted_rate_cents (integer cents) is included only for an admin member's key that holds finance:read. Paged with page/limit (limit ≤ 100, default 50).
list_list_memberslists:read- admin, manager, scout, viewer
- Ignored (read)
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.limit queryinteger — Page size, default 50.page queryinteger — 1-based page, default 1.Responses
PATCH/api/v1/lists/{list_id}/members
One atomic membership change through the canonical helper (changeListMembers — the same RPC as the app and Atlas): add_creator_ids must be ACTIVE roster creators of this workspace (400 otherwise), a creator cannot be both added and removed, adding an existing member is a no-op. Returns the counts and the list's new updated_at.
change_list_memberslists:write- admin, manager
- optional
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.add_creator_ids bodyarray of string (uuid)remove_creator_ids bodyarray of string (uuid)Responses
PATCH/api/v1/lists/{list_id}/order
Reorders through the canonical helper (reorderListMembers, the same RPC as the app's drag-and-drop): creator_ids must be exactly the list's current members. expected_updated_at is required (428 when missing); a list changed since is 409 stale_target; a membership mismatch is 409 conflict.
reorder_list_memberslists:write- admin, manager
- optional
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.creator_ids body, requiredarray of string (uuid)expected_updated_at bodystring — The record's updated_at as you last read it (ISO 8601). Required on updates: a missing one is 428 expected_updated_at_required, an older one 409 stale_target.Responses
POST/api/v1/lists/{list_id}/duplicate
Duplicates through the canonical helper (duplicateListFromId, as the app's Duplicate): members, their order and their quoted rates are copied; name defaults to "<name> copy". Returns 201 with the new list.
duplicate_listlists:write- admin, manager
- optional
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.color bodystring — #rrggbbdescription bodystring | nullname bodystringResponses
PATCH/api/v1/lists/{list_id}/members/{creator_id}
Sets one member's quoted rate on a list (integer cents, 0-100,000,000; null clears it) through the canonical helper (the app's rate cell write). Quoted rates are agency financial data: the key needs lists:write AND finance:read and an admin member. A creator who is not on the list is 404.
set_list_member_ratelists:write+finance:read- admin
- optional
- 1
Input
list_id path, requiredstring (uuid) — List id in this workspace.creator_id path, requiredstring (uuid) — A creator on this list.Idempotency-Key headerstring — Retry-safe key (1-255 printable ASCII; a UUID is recommended; an RFC 8941 quoted string is accepted). The same key with the same request within 24h replays the stored response byte for byte (Idempotent-Replayed: true) without running again; the replay still consumes the operation's rate weight.quoted_rate_cents body, requiredinteger | null