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

# 渠道模板

> 获取工作区中所有渠道外展模板的列表。



## OpenAPI

````yaml cn-openapi POST /channels/templates
openapi: 3.0.0
info:
  description: >-
    Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖
    200+ 市场、带类型与日期的动向信号。
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/zh-CN/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/zh-CN/get-in-touch
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.pubrio.com
security:
  - pubrio_api_key: []
tags:
  - name: Profile
    description: 工作区配置信息和使用统计
  - name: Enrichment
    description: 通过详细的 B2B 数据丰富人员和公司记录
  - name: Lookalike
    description: 查找与指定公司相似的公司
  - name: Search
    description: 使用筛选条件搜索人员、公司、职位、新闻和广告
  - name: Lookup
    description: 查找特定人员、公司、职位、新闻、广告和技术的详细信息
  - name: LinkedIn
    description: 通过 LinkedIn 个人资料 URL 查找人员和公司数据
  - name: Redeem
    description: 兑换积分以解锁人员联系方式（单个和批量）
  - name: Channels
    description: 管理外展渠道模板（创建、更新、删除、列表）
  - name: Monitor
    description: 创建和管理数据监控，包括 Webhook、统计和处理
  - name: Filters
    description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等）
  - name: API Keys
    description: 查看 API 密钥的请求日志和使用情况分析
  - name: Insights
    description: 公司的信号聚合洞察(招聘、新闻、广告)。
  - name: Export
    description: 批量数据导出(消耗积分)。
  - name: Expansion
    description: 公司市场扩张情报:信号、阶段、市场与导出。
externalDocs:
  description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。
  url: https://docs.pubrio.com
paths:
  /channels/templates:
    post:
      tags:
        - Channels
      summary: 列出渠道模板
      description: 获取工作区中所有渠道外展模板的列表。
      operationId: channels_list_templates
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channel_template_name:
                  $ref: '#/components/schemas/channel_template_name'
                channel_nodes:
                  $ref: '#/components/schemas/channel_nodes'
                channel_types:
                  $ref: '#/components/schemas/channel_types'
                per_page:
                  $ref: '#/components/schemas/per_page'
                page:
                  $ref: '#/components/schemas/page'
      responses:
        '200':
          description: 包含相关详细信息的成功响应。
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/data'
                    properties:
                      channel_templates:
                        type: array
                        description: >-
                          模板正文。**其字段取决于渠道类型**，因此解析前请先读取
                          `channel_type_slug`：`email` →
                          `subject`、`content`、`attachments`；`linkedin`（聊天消息）→
                          `message`、`attachments`；`linkedin`（邀请）→
                          `message`；`twilio` → `message`、`from`、`method`。
                        items:
                          type: object
              example:
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 4
                    total_pages: 1
                    is_timeout: false
                  channel_templates:
                    - channel_template_id: 1
                      channel_template_identifier: 4f6f40cb-ed6d-4cca-99d8-616feef8de93
                      channel_node_id: 93873c33-2635-4537-928c-6a4f3564164c
                      channel_node_slug: send_email
                      channel_type_id: 1
                      channel_type_slug: email
                      owner_email: example@pubrio.com
                      owner_name: Owner
                      name: email
                      version_number: 1
                      version_name: version 1
                      is_default: true
                      is_personal: true
                      created_at: '2025-07-29T09:07:11.969Z'
                      last_modified: '2025-07-29T09:07:11.969Z'
                      channel_template_versions:
                        - channel_template_id: 1
                          channel_template_identifier: 4f6f40cb-ed6d-4cca-99d8-616feef8de93
                          channel_node_id: 93873c33-2635-4537-928c-6a4f3564164c
                          channel_node_slug: send_email
                          channel_type_id: 1
                          channel_type_slug: email
                          owner_email: example@pubrio.com
                          owner_name: Owner
                          name: email
                          parameters:
                            content: <div>hello world</div>
                            subject: Hello World
                            attachments: []
                          version_number: 1
                          version_name: version 1
                          default_values: null
                          is_default: true
                          is_personal: true
                          created_at: '2025-07-29T09:07:11.969581'
                          last_modified: '2025-07-29T09:07:11.969581'
                    - ...
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    channel_template_name:
      type: string
      example: channel template
      description: 过滤搜索结果以包含特定的渠道模板名称。
    channel_nodes:
      type: array
      items:
        type: string
        format: uuid
      description: 用于搜索特定渠道节点的 `channel_node_id` 列表。
    channel_types:
      type: array
      items:
        type: integer
      example:
        - 1
        - 2
      description: 用于搜索特定渠道类型的 `channel_type_id` 列表。
    per_page:
      type: integer
      example: 25
      default: 25
      maximum: 25
      description: >-
        每页记录数。默认 25，在大多数套餐下这也是上限 —— 该限制即订阅中的 `max_search_per_page`，可通过
        [Profile](/cn/api-reference/endpoint/profile/profile) 获取。超出会返回 **HTTP
        416** 及错误码 `41676`（公司与人物搜索为 `41613`），而不是自动截断结果。
    page:
      type: integer
      example: 1
      default: 1
      description: >-
        页码，从 1 开始。上限为订阅中的 `max_search_page`（公司搜索为 `max_company_search_page`），可通过
        [Profile](/cn/api-reference/endpoint/profile/profile) 获取。超出会返回 **HTTP
        416**。
    data:
      type: object
      nullable: true
      description: 响应信息取决于具体接口。
  responses:
    general_error:
      description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: 错误及代码会根据不同场景有所不同，详情请参阅文档。
                type: string
              details:
                type: object
    rate_limit_error:
      description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: 请求频率超出限制。请稍后再试。
                type: string
    server_error:
      description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: 服务器在处理请求时遇到了未预料的异常。
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在
        [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。
      in: header

````