PATCH/desk/api/v2/inboxes/update.json

Update multiple inboxes.

Update all the given properties for matching resources. Any omitted properties will be unchanged.

        The following values are allowed in the [filter](https://apidocs.teamwork.com/guides/desk/filtering-api-results) query parameter:
  • autoReplyEnabled
  • autoReplyFromUserId
  • autoReplyMessage
  • autoReplySubject
  • clientOnly
  • createdAt
  • createdBy
  • defaultTeamAgent
  • deletedAt
  • deletedBy
  • displayOrder
  • email
  • emailForwardingState
  • happinessRatingEnabled
  • happinessRatingMessage
  • iconImage
  • id
  • includeTicketHistoryOnForward
  • isAdmin
  • languageCode
  • localPart
  • name
  • notificationsOnly
  • onClosedLock
  • onClosedWait
  • publicIconImage
  • sendEmailsFrom
  • showTrends
  • signature
  • smtpPassword
  • smtpPort
  • smtpProvider
  • smtpSecurity
  • smtpServer
  • smtpUsername
  • spamThreshold
  • starred
  • state
  • syncAccountId
  • syncDays
  • syncSubscriptionId
  • synced
  • ticketstatus
  • timeloggingEnabled
  • timeloggingProjectId
  • type
  • updatedAt
  • updatedBy
  • useTeamworkMailServer
  • user
  • usingOfficeHours

Body Params

Inbox represents a Inbox.

    • Name
      autoReplyEnabled
      Type
      boolean
    • Name
      autoReplyFromUserId
      Type
      integer
    • Name
      autoReplyMessage
      Type
      string
    • Name
      autoReplySubject
      Type
      string
    • Name
      clientOnly
      Type
      boolean
    • Name
      createdAt
      Type
      string
      Description
      CreatedAt is a read-only date marking the creation time.
    • Name
      createdBy
      Type
      object
    • Name
      defaultTeamAgent
      Type
      object
    • Name
      deletedAt
      Type
      string
      Description
      DeletedAt is a read-only date marking the time of deletion. Is only returned when the object is marked as deleted.
    • Name
      deletedBy
      Type
      object
    • Name
      displayOrder
      Type
      integer
    • Name
      email
      Type
      string
    • Name
      emailForwardingState
      Type
      string
    • Name
      filter_args
      Type
      object
      Description
      RequestCommons allows specifying paging and sorting options. All API endpoints should embed the RequestOrder for consistency.
    • Name
      forwardingAddress
      Type
      string
    • Name
      happinessRatingEnabled
      Type
      boolean
    • Name
      happinessRatingMessage
      Type
      string
    • Name
      iconImage
      Type
      string
    • Name
      id
      Type
      integer
    • Name
      inboxaliases
      Type
      array
      Description
      RelUser is the owner of the inbox when the inbox is personal
    • Name
      inboxcnames
      Type
      array
    • Name
      inboxemailrefs
      Type
      array
    • Name
      includeTicketHistoryOnForward
      Type
      boolean
      Description
      IncludeTicketHistoryOnForward controls whether ticket history is included in forwarded tickets.
    • Name
      isAdmin
      Type
      boolean
    • Name
      isFreeDomain
      Type
      boolean
    • Name
      languageCode
      Type
      string
    • Name
      localPart
      Type
      string
    • Name
      name
      Type
      string
    • Name
      notificationsOnly
      Type
      boolean
    • Name
      oauth2token
      Type
      object
    • Name
      onClosedLock
      Type
      string
    • Name
      onClosedWait
      Type
      integer
    • Name
      projects
      Type
      array
    • Name
      publicIconImage
      Type
      string
    • Name
      restricteddomains
      Type
      array
    • Name
      sendEmailsFrom
      Type
      string
    • Name
      showTrends
      Type
      boolean
    • Name
      signature
      Type
      string
    • Name
      smtpPassword
      Type
      string
    • Name
      smtpPort
      Type
      integer
    • Name
      smtpProvider
      Type
      string
    • Name
      smtpSecurity
      Type
      string
    • Name
      smtpServer
      Type
      string
    • Name
      smtpUsername
      Type
      string
    • Name
      spamThreshold
      Type
      integer
    • Name
      starred
      Type
      boolean
    • Name
      state
      Type
      string
      Description
      State is the status of the object. Typically this will be either active or deleted. When deleted the `deletedAt` and `deletedBy` relationship will be returned.
    • Name
      syncAccountId
      Type
      integer
    • Name
      syncDays
      Type
      integer
    • Name
      syncSubscriptionId
      Type
      integer
    • Name
      synced
      Type
      boolean
    • Name
      ticketstatus
      Type
      object
    • Name
      tickettypes
      Type
      array
    • Name
      timeloggingEnabled
      Type
      boolean
    • Name
      timeloggingProjectId
      Type
      integer
    • Name
      triggers
      Type
      array
    • Name
      type
      Type
      string
      Description
      Type is either "shared" or "personal", with "shared" being the default.
    • Name
      updatedAt
      Type
      string
      Description
      UpdatedAt is a read-only date marking the last updated time. This field is not updated when the object is deleted.
    • Name
      updatedBy
      Type
      object
    • Name
      useTeamworkMailServer
      Type
      boolean
    • Name
      user
      Type
      object
    • Name
      users
      Type
      array
    • Name
      usingOfficeHours
      Type
      boolean
    • Name
      verified
      Type
      boolean

    Responses

    • Code
      200
      Type
      object
      Schema
      Description
      200 OK
      BulkOpResponse is a bulk operation response
    • Code
      400
      Type
      object
      Schema
      Description
      400 Bad Request
      Validator hold the validation errors. Typically you shouldn't create this directly but use the New() function.

    Examples

    200 OK

    BulkOpResponse
    {
  "jobId": "string"
}
    Download Swagger