> ## Documentation Index > Fetch the complete documentation index at: https://docs.tented.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update a contact list > Patch a contact list. `kind` is immutable; `rules` only apply to dynamic lists, and replacing them recomputes membership. ## OpenAPI ````yaml /api-reference/openapi.json patch /v1/contact-lists/{listId} openapi: 3.1.0 info: title: Tented API version: 1.0.0 description: >- The Tented public API: generate, publish, and manage AI-built web pages (tents), and run the email platform — contacts, reusable emails, one-time blasts, and triggered flows. ## Authentication Authenticate every request with a workspace API key: `Authorization: Bearer `. Keys are created in **Workspace Settings → API Keys** and are scoped to a single workspace. ## Asynchronous work Tent generation, bulk creation, and email AI generation return `202 Accepted` immediately. Poll the corresponding status endpoint (`GET /v1/tents/{tentId}`, `GET /v1/bulk-jobs/{bulkJobId}`, `GET /v1/emails/{emailId}/generations/{generationId}`) — no more than every 10 seconds. ## Pagination Email listings use cursor pagination (`cursor`/`next_cursor`). Blast, flow, and member listings use page pagination (`page`/`limit` with a `pagination` object in the response). ## Conventions Request and response fields are snake_case, with two exceptions: analytics query parameters (`tentIdOrAlias`, `daysBack`) and segment rule trees (camelCase keys such as `listId` and `timeWindow`). contact: name: Tented Support email: support@tented.ai servers: - url: https://api.tented.ai description: Production security: - bearerAuth: [] tags: - name: Tents description: >- Create, edit, publish, and manage AI-generated pages, including asset uploads and bulk creation. - name: Analytics description: Traffic analytics for single tents and the whole workspace. - name: Contacts description: >- Batch create, update, and delete contacts. Up to 25 items per request with per-item results. - name: Emails description: >- Reusable email content: AI generation, direct HTML edits, plain-text control, and approval. - name: Email Blasts description: >- One-time sends to an audience: compose, schedule, track engagement, export recipients. - name: Triggered Flows description: >- Multi-step automations that enroll contacts on triggers and move them through a step graph. - name: Contact Imports - name: Contact Fields - name: Contact Lists - name: Email Templates - name: Tent Templates description: >- Reusable, AI-editable tent layouts. Create from HTML or an existing tent, iterate with AI, approve, and clone. Approved tent templates seed new tents. paths: /v1/contact-lists/{listId}: patch: tags: - Contact Lists summary: Update a contact list description: >- Patch a contact list. `kind` is immutable; `rules` only apply to dynamic lists, and replacing them recomputes membership. operationId: update-contact-list parameters: - name: listId in: path required: true schema: type: string format: uuid description: Contact list ID. requestBody: required: true content: application/json: schema: type: object properties: name: type: string minLength: 1 maxLength: 255 description: >- List name (1-255 chars). Must be unique within the workspace. description: type: - string - 'null' maxLength: 1000 description: Optional description (max 1,000 chars). Pass null to clear. rules: anyOf: - $ref: '#/components/schemas/RuleGroup' - type: 'null' description: >- Replacement segment rule tree for a dynamic list; membership is recomputed. Not applicable to static lists. `email_step` conditions are not allowed. minProperties: 1 additionalProperties: false description: At least one field is required. responses: '200': description: The updated contact list. content: application/json: schema: $ref: '#/components/schemas/ContactList' '400': description: >- Bad request — invalid parameters or request body (e.g. an empty patch, or `rules` on a static list). Validation failures include `details.issues` with per-field messages. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized — missing, malformed, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- Forbidden — system lists cannot be edited (`error_code: "system_list_protected"`). content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- Not found — the resource does not exist in the workspace tied to your API key. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- Conflict — a list with this name already exists (`error_code: "contact_list_name_exists"`). content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: RuleGroup: type: object properties: kind: type: string enum: - group description: Set to `group` (default when `conditions` is present). operator: type: string enum: - and - or default: and description: How child conditions combine. conditions: type: array items: $ref: '#/components/schemas/RuleNode' description: >- Child nodes. Groups nest up to 5 levels; a tree may contain at most 100 nodes. required: - conditions ContactList: type: object properties: list_id: type: string format: uuid description: Contact list ID. name: type: string description: List name. Unique within the workspace. slug: type: - string - 'null' description: URL-safe identifier derived from the name. description: type: - string - 'null' description: Optional description. kind: type: string enum: - static - dynamic - system description: >- static = membership managed manually via the member endpoints; dynamic = membership computed continuously from rules; system = auto-managed by the platform (read-only). Immutable after creation. rules: anyOf: - $ref: '#/components/schemas/RuleGroup' - type: 'null' description: Segment rule tree for dynamic lists; `null` for static lists. member_count: type: - integer - 'null' description: >- Stored member count for static lists; `null` for dynamic lists — use `GET /v1/contact-lists/{listId}/member-count` for a live count. owner_campaign_id: type: - string - 'null' format: uuid description: >- Set when the list is a blast's inline audience; `null` for user-created lists. created_at: type: string format: date-time description: Creation time. updated_at: type: string format: date-time description: Last update. required: - list_id - name - kind - created_at - updated_at Error: type: object properties: error: type: string description: Human-readable error message. error_code: type: string description: >- Stable machine-readable error code (present on email, blast, flow, and related endpoints, e.g. `campaign_not_ready`, `generation_in_progress`). message: type: string description: Additional human-readable context (present on some tent endpoints). code: type: string description: >- Machine-readable code used by tent creation errors (e.g. `INVALID_PROMPT_INTENT`). details: type: object additionalProperties: true description: >- Additional error context. Validation errors include `issues`: an array of `{ path, message }` objects. limit: type: integer description: Plan limit that was hit (present on `429` publish-limit errors). current: type: integer description: >- Current usage against the limit (present on `429` publish-limit errors). required: - error description: >- Error response. All errors include `error`; the other fields vary by endpoint group. RuleNode: oneOf: - $ref: '#/components/schemas/RuleGroup' - $ref: '#/components/schemas/RuleCondition' description: >- A rule tree node: either a group of nested conditions or a single condition. NOTE: rule trees use camelCase keys (`listId`, `fieldDefinitionId`, `timeWindow`), unlike the rest of the API. RuleCondition: type: object properties: kind: type: string enum: - condition description: >- Set to `condition` (default when `operator` is present without `conditions`). source: type: string enum: - contact - custom_field - activity - list_membership - email_step default: contact description: What the condition tests. field: type: string description: >- Standard contact field in camelCase (e.g. `leadStatus`, `tentedScore`, `createdAt`). Used with `source: contact`. fieldDefinitionId: type: string format: uuid description: 'Active custom-field definition ID. Used with `source: custom_field`.' activityType: type: string description: >- Activity type (e.g. `form_submission`). Used with `source: activity`. listId: type: string format: uuid description: 'Static list ID. Used with `source: list_membership`.' nodeId: type: string description: >- `step_id` of an earlier `send_email` step. Used with `source: email_step` (flows only). metric: type: string enum: - sent - delivered - opened - clicked - bounced - unsubscribed description: 'Email engagement metric. Used with `source: email_step`.' operator: type: string description: >- Comparison operator. Strings: `equals`, `not_equals`, `contains`, `not_contains`, `starts_with`, `ends_with`. Numbers/dates: `equals`, `not_equals`, `greater_than`, `greater_than_or_equal`, `less_than`, `less_than_or_equal`. Booleans: `is_true`, `is_false`. Any: `is_empty`, `is_not_empty`. Membership: `is_member`, `is_not_member`. Activity: `has_activity`, `has_no_activity`. Shorthand aliases (`eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `member_of`) are accepted. value: description: Comparison value, when the operator takes one. timeWindow: type: object properties: amount: type: integer minimum: 1 maximum: 1000 description: Window size. unit: type: string enum: - hour - day - week - month - year description: Window unit. description: Optional look-back window for activity conditions. required: - operator securitySchemes: bearerAuth: type: http scheme: bearer description: >- Workspace API key, e.g. `Authorization: Bearer tented_...`. Create keys in Workspace Settings → API Keys. ````