TT-4429: CRUDs for rules/policies/lists, new feature (#312)

Author: googsvg

.claude/settings.local.json

@@ -15,3 +15,6 @@ out
 .idea
 .DS_Store
 src/main/kotlin/com/nylas/Main.kt
+
+# Claude Code per-user local settings (not shared)
+.claude/settings.local.json

.gitignore

@@ -8,6 +8,10 @@
   - `NylasClient.domains()` accessor returning the new `Domains` resource
   - Automatic multipart/form-data upload when the total attachment size exceeds the JSON limit
   - Examples: `TransactionalEmailExample.java` and `KotlinTransactionalEmailExample.kt`
+* Administration API — Policies, Rules, and Lists (app-level, `nylas` provider only)
+  - `Policies` resource via `client.policies()`: full CRUD (`list`, `find`, `create`, `update`, `destroy`) with `CreatePolicyRequest` / `UpdatePolicyRequest` and supporting models (`Policy`, `PolicyLimits`, `PolicyOptions`, `PolicySpamDetection`)
+  - `Rules` resource via `client.rules()`: full CRUD with `CreateRuleRequest` / `UpdateRuleRequest` and supporting models (`Rule`, `RuleAction`, `RuleActionType`, `RuleCondition`, `RuleConditionOperator`, `RuleMatch`, `RuleMatchOperator`, `RuleTrigger`)
+  - `NylasLists` resource via `client.lists()`: full CRUD plus `listItems`, `addItems`, and `removeItems` for managing list contents; `NylasList`, `NylasListItem`, `NylasListType`, `ListItemsRequest` models
 
 ## [v2.16.1] - Release 2026-05-21
 

CHANGELOG.md

@@ -171,6 +171,24 @@ open class NylasClient(
    */
   open fun notetakers(): Notetakers = Notetakers(this)
 
+  /**
+   * Access the Policies API
+   * @return The Policies API
+   */
+  open fun policies(): Policies = Policies(this)
+
+  /**
+   * Access the Rules API
+   * @return The Rules API
+   */
+  open fun rules(): Rules = Rules(this)
+
+  /**
+   * Access the Lists API
+   * @return The Lists API
+   */
+  open fun lists(): NylasLists = NylasLists(this)
+
   /**
    * Get a URL builder instance for the Nylas API.
    */

src/main/kotlin/com/nylas/NylasClient.kt

@@ -0,0 +1,49 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Class representation of a Nylas create list request.
+ */
+data class CreateNylasListRequest(
+  /**
+   * Name of the list (1–256 characters).
+   */
+  @Json(name = "name")
+  val name: String,
+  /**
+   * The type of values this list will hold. Immutable after creation.
+   */
+  @Json(name = "type")
+  val type: NylasListType,
+  /**
+   * Optional description of the list.
+   */
+  @Json(name = "description")
+  val description: String? = null,
+) {
+  /**
+   * Builder for [CreateNylasListRequest].
+   * @param name Name of the list.
+   * @param type The type of values this list will hold.
+   */
+  class Builder(
+    private val name: String,
+    private val type: NylasListType,
+  ) {
+    private var description: String? = null
+
+    /**
+     * Set the description of the list.
+     * @param description Optional description of the list.
+     * @return The builder.
+     */
+    fun description(description: String) = apply { this.description = description }
+
+    /**
+     * Build the [CreateNylasListRequest].
+     * @return A [CreateNylasListRequest] with the provided values.
+     */
+    fun build() = CreateNylasListRequest(name, type, description)
+  }
+}

src/main/kotlin/com/nylas/models/CreateNylasListRequest.kt

@@ -0,0 +1,81 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Class representation of a Nylas create policy request.
+ */
+data class CreatePolicyRequest(
+  /**
+   * Name of the policy.
+   */
+  @Json(name = "name")
+  val name: String,
+  /**
+   * Optional mailbox and behavior settings.
+   */
+  @Json(name = "options")
+  val options: PolicyOptions? = null,
+  /**
+   * Resource and rate limits for agent accounts using this policy.
+   */
+  @Json(name = "limits")
+  val limits: PolicyLimits? = null,
+  /**
+   * IDs of rules to link to this policy.
+   */
+  @Json(name = "rules")
+  val rules: List<String>? = null,
+  /**
+   * Spam detection configuration.
+   */
+  @Json(name = "spam_detection")
+  val spamDetection: PolicySpamDetection? = null,
+) {
+  /**
+   * Builder for [CreatePolicyRequest].
+   * @param name Name of the policy.
+   */
+  class Builder(
+    private val name: String,
+  ) {
+    private var options: PolicyOptions? = null
+    private var limits: PolicyLimits? = null
+    private var rules: List<String>? = null
+    private var spamDetection: PolicySpamDetection? = null
+
+    /**
+     * Set the mailbox and behavior settings.
+     * @param options Optional mailbox and behavior settings.
+     * @return The builder.
+     */
+    fun options(options: PolicyOptions) = apply { this.options = options }
+
+    /**
+     * Set the resource and rate limits.
+     * @param limits Resource and rate limits for agent accounts using this policy.
+     * @return The builder.
+     */
+    fun limits(limits: PolicyLimits) = apply { this.limits = limits }
+
+    /**
+     * Set the IDs of rules to link to this policy.
+     * @param rules IDs of rules to link to this policy.
+     * @return The builder.
+     */
+    fun rules(rules: List<String>) = apply { this.rules = rules }
+
+    /**
+     * Set the spam detection configuration.
+     * @param spamDetection Spam detection configuration.
+     * @return The builder.
+     */
+    fun spamDetection(spamDetection: PolicySpamDetection) = apply { this.spamDetection = spamDetection }
+
+    /**
+     * Build the [CreatePolicyRequest].
+     * @return A [CreatePolicyRequest] with the provided values.
+     */
+    fun build() = CreatePolicyRequest(name, options, limits, rules, spamDetection)
+  }
+}

src/main/kotlin/com/nylas/models/CreatePolicyRequest.kt

@@ -0,0 +1,96 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Class representation of a Nylas create rule request.
+ */
+data class CreateRuleRequest(
+  /**
+   * Name of the rule.
+   */
+  @Json(name = "name")
+  val name: String,
+  /**
+   * When this rule is evaluated.
+   */
+  @Json(name = "trigger")
+  val trigger: RuleTrigger,
+  /**
+   * The match conditions for this rule.
+   */
+  @Json(name = "match")
+  val match: RuleMatch,
+  /**
+   * The actions to perform when conditions are met.
+   */
+  @Json(name = "actions")
+  val actions: List<RuleAction>,
+  /**
+   * Optional description of the rule.
+   */
+  @Json(name = "description")
+  val description: String? = null,
+  /**
+   * Evaluation order — lower numbers run first. Range 0–1000, default 10.
+   */
+  @Json(name = "priority")
+  val priority: Int? = null,
+  /**
+   * Whether the rule is active. Defaults to true.
+   */
+  @Json(name = "enabled")
+  val enabled: Boolean? = null,
+) {
+  init {
+    require(!(actions.any { it.type == RuleActionType.BLOCK } && actions.size > 1)) {
+      "RuleActionType.BLOCK is terminal and cannot be combined with other actions."
+    }
+  }
+
+  /**
+   * Builder for [CreateRuleRequest].
+   * @param name Name of the rule.
+   * @param trigger When this rule is evaluated.
+   * @param match The match conditions.
+   * @param actions The actions to perform.
+   */
+  class Builder(
+    private val name: String,
+    private val trigger: RuleTrigger,
+    private val match: RuleMatch,
+    private val actions: List<RuleAction>,
+  ) {
+    private var description: String? = null
+    private var priority: Int? = null
+    private var enabled: Boolean? = null
+
+    /**
+     * Set the description of the rule.
+     * @param description Optional description of the rule.
+     * @return The builder.
+     */
+    fun description(description: String) = apply { this.description = description }
+
+    /**
+     * Set the evaluation priority.
+     * @param priority Evaluation order — lower numbers run first. Range 0–1000.
+     * @return The builder.
+     */
+    fun priority(priority: Int) = apply { this.priority = priority }
+
+    /**
+     * Set whether the rule is active.
+     * @param enabled Whether the rule is active.
+     * @return The builder.
+     */
+    fun enabled(enabled: Boolean) = apply { this.enabled = enabled }
+
+    /**
+     * Build the [CreateRuleRequest].
+     * @return A [CreateRuleRequest] with the provided values.
+     * @throws IllegalArgumentException if [RuleActionType.BLOCK] is combined with other actions.
+     */
+    fun build() = CreateRuleRequest(name, trigger, match, actions, description, priority, enabled)
+  }
+}

src/main/kotlin/com/nylas/models/CreateRuleRequest.kt

@@ -0,0 +1,34 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Class representation of a request to add or remove items in a Nylas list.
+ */
+data class ListItemsRequest(
+  /**
+   * The values to add or remove. Max 1000 items per request.
+   */
+  @Json(name = "items")
+  val items: List<String>,
+) {
+  /**
+   * Builder for [ListItemsRequest].
+   */
+  class Builder {
+    private var items: List<String> = emptyList()
+
+    /**
+     * Set the items to add or remove.
+     * @param items The values to add or remove. Max 1000 items per request.
+     * @return The builder.
+     */
+    fun items(items: List<String>) = apply { this.items = items }
+
+    /**
+     * Build the [ListItemsRequest].
+     * @return A [ListItemsRequest] with the provided values.
+     */
+    fun build() = ListItemsRequest(items)
+  }
+}

src/main/kotlin/com/nylas/models/ListItemsRequest.kt

@@ -0,0 +1,47 @@
+package com.nylas.models
+
+import com.squareup.moshi.Json
+
+/**
+ * Class representation of the query parameters for listing items in a Nylas list.
+ */
+data class ListNylasListItemsQueryParams(
+  /**
+   * The maximum number of objects to return.
+   */
+  @Json(name = "limit")
+  val limit: Int? = null,
+  /**
+   * Cursor for pagination. Pass the value of [ListResponse.nextCursor] to get the next page.
+   */
+  @Json(name = "page_token")
+  val pageToken: String? = null,
+) : IQueryParams {
+  /**
+   * Builder for [ListNylasListItemsQueryParams].
+   */
+  class Builder {
+    private var limit: Int? = null
+    private var pageToken: String? = null
+
+    /**
+     * Set the maximum number of objects to return.
+     * @param limit The maximum number of objects to return.
+     * @return The builder.
+     */
+    fun limit(limit: Int) = apply { this.limit = limit }
+
+    /**
+     * Set the pagination cursor.
+     * @param pageToken Cursor for pagination. Pass the value of [ListResponse.nextCursor].
+     * @return The builder.
+     */
+    fun pageToken(pageToken: String) = apply { this.pageToken = pageToken }
+
+    /**
+     * Build the [ListNylasListItemsQueryParams].
+     * @return A [ListNylasListItemsQueryParams] with the provided values.
+     */
+    fun build() = ListNylasListItemsQueryParams(limit, pageToken)
+  }
+}