> ## Documentation Index
> Fetch the complete documentation index at: https://talktohumans.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Update view

> Update a saved view's filters, sorts, and settings



## OpenAPI

````yaml /developers/openapi.yaml patch /v1/views/{view_id}
openapi: 3.0.3
info:
  title: TalkToHumans Public API
  version: 1.0.0
  license:
    name: Proprietary
  description: >
    Read and organize the LinkedIn organization data your team already manages
    in TalkToHumans: accounts, contacts, tags, notes, sequence state,
    conversations, templates, and views.
servers:
  - url: https://api.talktohumans.app
    description: TalkToHumans API
security:
  - bearerAuth: []
tags:
  - name: Organization
    description: Organization details for the current API key.
  - name: LinkedIn
    description: LinkedIn accounts, contacts, companies, and conversations.
  - name: Activity
    description: Activity for organization reporting.
  - name: Enrich
    description: Profile enrichment for LinkedIn contacts and companies.
  - name: Views
    description: Saved TalkToHumans views.
  - name: Templates
    description: Message and sequence templates.
paths:
  /v1/views/{view_id}:
    patch:
      tags:
        - Views
      summary: Update view
      description: Update a saved view's filters, sorts, and settings
      operationId: updateView
      parameters:
        - name: view_id
          in: path
          required: true
          description: View `id` or unambiguous `public_id` returned by `GET /v1/views`.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateViewRequest'
            examples:
              filters:
                summary: Replace filters
                value:
                  filters:
                    - field: is_unread
                      operator: '='
                      value: true
              removeGrouping:
                summary: Remove grouping
                value:
                  group_by: ''
              rename:
                summary: Rename a view
                value:
                  name: Warm leads
      responses:
        '200':
          description: View updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ViewEnvelope'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/AccountScopedForbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    UpdateViewRequest:
      type: object
      additionalProperties: false
      description: >-
        Provide at least one field besides `account_id`. Omitted fields are
        unchanged.
      properties:
        account_id:
          type: string
          description: >-
            LinkedIn account ID returned by `GET /v1/accounts`. Must be the
            view's account.
          pattern: ^[1-9][0-9]*$
        name:
          type: string
          minLength: 1
          maxLength: 120
        description:
          type: string
          description: An empty string removes the description.
        view_type:
          $ref: '#/components/schemas/ViewType'
        filters:
          type: array
          description: Replacement for all filters. An empty list removes them.
          items:
            $ref: '#/components/schemas/ViewFilter'
        sorts:
          type: array
          description: >-
            Replacement for the sort order. An empty list restores the default
            order.
          items:
            $ref: '#/components/schemas/ViewSort'
        group_by:
          type: string
          description: >-
            Field to group conversations by. An empty string removes grouping.
            Inboxes only.
        count_mode:
          $ref: '#/components/schemas/ViewCountMode'
        visibility_mode:
          $ref: '#/components/schemas/ViewVisibilityMode'
        conversation_open_mode:
          $ref: '#/components/schemas/ViewConversationOpenMode'
        is_hidden:
          type: boolean
    ViewEnvelope:
      type: object
      additionalProperties: false
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/ViewResponse'
    ViewType:
      type: string
      description: Layout of contact and company views. Inboxes are always `table`.
      enum:
        - table
        - map
    ViewFilter:
      type: object
      additionalProperties: false
      required:
        - field
        - operator
      properties:
        field:
          type: string
          description: >
            Field key for the view's type.

            Inboxes: `conversation_type`, `has_conversation`, `reply_state`,
            `is_scheduled`, `next_scheduled_step_date`,
            `next_scheduled_step_type`, `schedule_status`, `has_draft`,
            `last_message_date`, `is_favorite`, `is_archived`, `is_muted`,
            `is_unread`.

            Contact views: `full_name`, `job_title`, `headline`,
            `follower_count`, `is_enriched`, `is_in_crm`, `work_email`, `phone`,
            `specific_contacts`, `tags`, `invite_type`, `relationship_status`,
            `connected_at`, `imported_at`, `imported_source`, `country`,
            `state`, `city`, `timezone`, `notes`, `invite_received_at`.

            Company views: `company_name`, `industry`, `country`, `state`,
            `city`, `employee_range`, `employee_count`, `is_in_crm`, `tags`,
            `notes`.

            Prefix `member.`, `company.`, or `conversation.` to filter on a
            related record, such as `member.tags` in an inbox. Custom fields use
            `custom_fields.<name>`.
          example: tags
        operator:
          type: string
          enum:
            - '='
            - '!='
            - contains
            - doesNotContain
            - 'null'
            - notNull
            - <
            - <=
            - '>'
            - '>='
            - relativeToToday
            - between
            - notBetween
        value:
          description: >
            Omit for `null` and `notNull`. Text and `contains` filters take a
            list of strings. `tags` takes tag names, `specific_contacts` takes
            contact IDs from `GET /v1/contacts`, and `industry` takes
            `industry_urn` values.

            Dates take `YYYY-MM-DD`, `{"from", "to"}` for `between`, or
            `{"direction": "past" | "next" | "this", "amount", "unit": "day" |
            "week" | "month" | "quarter" | "year"}` for `relativeToToday`.
    ViewSort:
      type: object
      additionalProperties: false
      required:
        - field
        - direction
      properties:
        field:
          type: string
          description: Field key, as in `ViewFilter`.
        direction:
          type: string
          enum:
            - asc
            - desc
    ViewCountMode:
      type: string
      description: Count shown next to an inbox in the sidebar.
      enum:
        - unread
        - total
    ViewVisibilityMode:
      type: string
      description: When an inbox is shown in the sidebar.
      enum:
        - always
        - when_unread
        - when_not_empty
    ViewConversationOpenMode:
      type: string
      description: Whether an inbox opens conversations full page or beside the list.
      enum:
        - full
        - side_peek
    ViewResponse:
      type: object
      additionalProperties: false
      required:
        - view
      properties:
        view:
          $ref: '#/components/schemas/View'
    Error:
      type: object
      additionalProperties: false
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Machine-readable error code.
          enum:
            - unauthorized
            - forbidden
            - not_found
            - bad_request
            - internal_error
            - conflict
            - rate_limit_exceeded
            - account_shared_access_required
            - billing_payment_failed
            - billing_subscription_incomplete
            - billing_subscription_expired
            - billing_grace_period
            - billing_feature_not_available
            - billing_insufficient_credits
            - billing_invalid
            - enrichment_failed
            - enrichment_in_progress
            - linkedin_profile_not_found
        message:
          type: string
          description: Human-readable error message.
        debug:
          type: string
          description: Development-only debug details.
    View:
      type: object
      additionalProperties: false
      required:
        - id
        - public_id
        - type
        - view_kind
        - name
        - account
        - view_type
        - filters
        - sorts
        - group_by
        - count_mode
        - visibility_mode
        - conversation_open_mode
        - is_hidden
        - app_url
        - created_at
        - updated_at
      properties:
        id:
          type: string
          description: >-
            TalkToHumans view ID. Pass as `view_id` to list its conversations,
            contacts, or companies.
        public_id:
          type: string
          description: >-
            Public saved-view ID used in app URLs. Also accepted as `view_id`
            when unambiguous.
        type:
          type: string
          enum:
            - contact
            - inbox
            - company
        view_kind:
          type: string
          description: View kind. Contact views use member.
          enum:
            - member
            - inbox
            - company
        name:
          type: string
        description:
          type: string
          nullable: true
        account:
          $ref: '#/components/schemas/AccountSummary'
        view_type:
          $ref: '#/components/schemas/ViewType'
        filters:
          type: array
          description: Filters shown in the view header. Records match all of them.
          items:
            $ref: '#/components/schemas/ViewFilter'
        sorts:
          type: array
          description: Sort order, first entry first. Empty uses the default order.
          items:
            $ref: '#/components/schemas/ViewSort'
        group_by:
          type: string
          nullable: true
          description: Field inbox conversations are grouped by.
        count_mode:
          $ref: '#/components/schemas/ViewCountMode'
        visibility_mode:
          $ref: '#/components/schemas/ViewVisibilityMode'
        conversation_open_mode:
          $ref: '#/components/schemas/ViewConversationOpenMode'
        is_hidden:
          type: boolean
          description: Hidden views are not shown in the sidebar.
        app_url:
          type: string
          format: uri
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    AccountSummary:
      type: object
      additionalProperties: false
      required:
        - account_id
        - display_name
        - provider_account_id
        - owner_user_id
      properties:
        account_id:
          type: string
          description: TalkToHumans account ID.
        display_name:
          type: string
        provider_account_id:
          type: string
          description: LinkedIn provider account ID.
        owner_user_id:
          type: string
          description: TalkToHumans user ID that owns the account.
  responses:
    BadRequest:
      description: Invalid request. `message` explains what to fix.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: bad_request
            message: invalid type for field "account_id"
    Unauthorized:
      description: Missing, malformed, invalid, or retired local API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            missingAuthorization:
              value:
                code: unauthorized
                message: Authorization header is required
            invalidAuthorizationFormat:
              value:
                code: unauthorized
                message: Authorization header must use Bearer scheme
            invalidAPIKey:
              value:
                code: unauthorized
                message: Invalid API key
    AccountScopedForbidden:
      description: >-
        API access is not enabled for the organization, the API key cannot
        resolve to an active organization user, or the credential cannot access
        the requested LinkedIn account.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          examples:
            accountSharedAccessRequired:
              summary: Requested account is not accessible to this credential
              value:
                code: account_shared_access_required
                message: >-
                  This account is not shared-access enabled for API or MCP. Ask
                  an admin to enable shared access before using this account
                  from this credential.
            forbidden:
              value:
                code: forbidden
                message: you don't have access to this organization
            featureUnavailable:
              value:
                code: billing_feature_not_available
                message: >-
                  Feature 'TalkToHumansAPI' is not available in your current
                  plan
            insufficientCredits:
              value:
                code: billing_insufficient_credits
                message: Insufficient credits
            apiKeyPrincipalInvalid:
              value:
                code: forbidden
                message: >-
                  This API key is no longer linked to an active organization
                  user. Ask an organization admin to regenerate it
    NotFound:
      description: Requested resource was not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: not_found
            message: participant not found
    Conflict:
      description: Request conflicts with an existing resource.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: conflict
            message: custom field key already exists
    RateLimited:
      description: >-
        Rate limit exceeded. Public routes allow 50 requests per 10 seconds per
        IP and endpoint.
      headers:
        Retry-After:
          description: Seconds to wait before retrying the request.
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: rate_limit_exceeded
            message: Rate limit exceeded
    InternalServerError:
      description: Unexpected server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: internal_error
            message: An internal error occurred
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Pass API key as `Authorization: Bearer <api_key>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.