telltell_batches_apply
ChatGPTApply an exact stored preview after rechecking permissions and versions. Requires jobs:write, the preview's original category scopes, and bulk access. AI clients should ask for approval first; the API requires no approval flag. Returns a durable job receipt; configured welcome emails may be sent. May queue configured welcome emails; queued messages remain effective after cancellation. Returns a durable job receipt promptly. Use job tools to poll or cancel.
telltell_batches_get
ChatGPTRead a page of a stored bulk preview, including proposed changes and conflicts. Requires the preview's original category scopes and continued bulk access.
telltell_batches_preview
ChatGPTStore an exact preview of bulk field edits, group assignments, or a CSV import without changing directory records. Field batches additionally require people:write and fields:read; membership batches require groups:read and groups:write; imports require all four. Read all preview pages before requesting conversational approval. API scripts may preview and apply unattended.
telltell_context_get
ChatGPTRead the connected TellTell account, current scopes, and bulk-edit policy.
telltell_fields_create
ChatGPTCreate a custom-field definition with explicit type and configuration. Person relationship fields require both forwardLabel and reverseLabel, such as Parent and Child; do not invent labels the user did not provide.
telltell_fields_get
ChatGPTRead a custom-field or Tags definition, its choices, current version, and both relationship labels when configured. forwardLabel is the primary side (value / relationshipPersonIds); reverseLabel is the reciprocal side (reverseValue / reverseRelationshipPersonIds). Labels are account-configured, such as Parent and Child; omit or ask when a label is missing instead of inventing one.
telltell_fields_list
ChatGPTSearch and list custom-field and Tags definitions in bounded pages. Relationship fields include both the configured primary (forwardLabel) and reciprocal (reverseLabel) labels, such as Parent and Child. Read the individual record before editing to obtain its current version.
telltell_fields_options_create
ChatGPTAdd a choice or tag to a field using the field's current version.
telltell_fields_options_delete
ChatGPTDelete a choice or tag and its assignments. Requires bulk access; present the impact and ask for approval in the conversation first.
telltell_fields_options_reorder
ChatGPTReorder choices within a field using its current version.
telltell_fields_options_replace
ChatGPTReplace a choice/tag with another in the same field, updating assignments. Requires bulk access and conversational approval.
telltell_fields_options_update
ChatGPTUpdate a choice or tag's label, color, and position using the parent field's current version.
telltell_fields_reorder
ChatGPTReorder custom-field definitions. Supply all definition IDs and their current versions.
telltell_fields_update
ChatGPTUpdate or archive a custom-field definition, preserving TellTell's protected Tags rules. Person relationship fields keep both configured labels; supply forwardLabel and reverseLabel together and do not invent missing labels.
telltell_groups_create
ChatGPTCreate a group in an existing team using its managed TellTell address.
telltell_groups_delete
ChatGPTRemove a group and its memberships. Present the impact and ask for approval in the conversation first.
telltell_groups_get
ChatGPTRead a group's address, sending/reply settings, notices, and current version.
telltell_groups_list
ChatGPTSearch and list groups in bounded pages. Read the individual record before editing to obtain its current version.
telltell_groups_notices_update
ChatGPTUpdate sanitized welcome-message and message-footer content. These settings affect future email; explain the changes and ask for approval in the conversation first.
telltell_groups_permissions_update
ChatGPTChange a group's permitted senders and reply behavior. Explain these mail-delivery changes and ask for approval in the conversation first.
telltell_groups_update
ChatGPTUpdate a group's name, managed address key, description, and color.
telltell_jobs_cancel
ChatGPTPermanently cancel remaining work for a job created by this connection; canceled work cannot be resumed. The current atomic item may finish; completed changes and queued mail are retained.
telltell_jobs_get
ChatGPTRead progress and failures for a job created by this connection.
telltell_jobs_list
ChatGPTList jobs created by this connection with bounded progress summaries.
telltell_memberships_set
ChatGPTAdd or remove one person's membership in one group. Adding membership honors configured welcome emails. Use the person's current version. May queue configured welcome emails; queued messages remain effective after cancellation.
telltell_people_create
ChatGPTCreate a person in the People directory with email addresses and optional custom-field values. May queue external automatic-photo lookups when enabled. For person relationships, value is the primary/forwardLabel side and reverseValue is the reciprocal/reverseLabel side. Only create people the user requested; never add placeholder contacts to test connectivity or discover schemas.
telltell_people_delete
ChatGPTRemove a person from the account. Clears both sides of their relationship links, removes their group memberships, and releases their email addresses so those addresses can be used again. Ask for approval in the AI conversation before calling.
telltell_people_fields_update
ChatGPTSet the selected custom-field or tag values on one person, preserving other fields. Use append or replace explicitly for multi-choice and person-relationship fields. Append adds to the selected side without removing existing values; replace sets that side to the supplied list. For person relationships, value updates the primary/forwardLabel side (such as Parent) and reverseValue updates the reciprocal/reverseLabel side (such as Child). Read the field definition when a label is missing rather than inventing one.
telltell_people_get
ChatGPTRead a person's emails, group assignments, custom-field values, and current version. Person relationships include relationshipPersonIds for the primary label (forwardLabel, such as Parent) and reverseRelationshipPersonIds for the reciprocal label (reverseLabel, such as Child), plus those configured labels when present. Do not invent missing labels.
telltell_people_list
ChatGPTSearch and list people in bounded pages. Read the individual record before editing to obtain its current version.
telltell_people_merge
ChatGPTMerge people into the selected primary person. Requires bulk access and current versions of every selected person. Present the proposed merge and ask for approval in the conversation first. May queue configured welcome emails; queued messages remain effective after cancellation.
telltell_people_update
ChatGPTUpdate a person's name, ordered email addresses (primary first), and optional field values. New email addresses may receive configured group welcome emails. For person relationships, value is the primary/forwardLabel side and reverseValue is the reciprocal/reverseLabel side. May queue configured welcome emails; queued messages remain effective after cancellation.
telltell_settings_get
ChatGPTRead ordinary account settings and their current version.
telltell_settings_update
ChatGPTUpdate the account name and automatic-photo preference. Disabling automatic photos removes stored automatic avatars; enabling them permits external photo lookups. Connection permissions, billing, login, and lifecycle settings are excluded.
telltell_teams_create
ChatGPTCreate a team within the account's existing plan entitlement.
telltell_teams_delete
ChatGPTRemove a team and its groups under existing TellTell rules. Present the impact and ask for approval in the conversation first.
telltell_teams_get
ChatGPTRead a team's ordinary settings and current version.
telltell_teams_list
ChatGPTSearch and list teams in bounded pages. Read the individual record before editing to obtain its current version.
telltell_teams_update
ChatGPTUpdate a team name, mail key, and optional directory columns. Changing the mail key changes its managed group addresses.
