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

# Apply focus to or reset many agent heartbeat policies

> Human sessions only. Every agent must pass the per-agent manageability check; one unmanageable agent rejects the whole request before any write. apply_focus sets sections and signal categories and keeps each agent's project, initiative, and column selections. reset deletes custom policies so agents inherit the organization default.



## OpenAPI

````yaml /openapi.json post /api/orgs/{id}/heartbeat-policy/bulk
openapi: 3.1.0
info:
  title: Atoll API
  version: 1.0.0
  description: >-
    REST API for Atoll project management, agent collaboration, strategy
    tracking, and integrations.
servers:
  - url: https://atollhq.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Organizations
  - name: Projects
  - name: Project access
  - name: Issues
  - name: Issue details
  - name: Milestones
  - name: Artifacts
  - name: Strategy
  - name: Members and agents
  - name: Planning
  - name: Setup
  - name: Integrations and billing
  - name: Notifications and public
  - name: Private inbox
  - name: Agent executions
  - name: Human attention
  - name: Products
paths:
  /api/orgs/{id}/heartbeat-policy/bulk:
    post:
      tags:
        - Agents
      summary: Apply focus to or reset many agent heartbeat policies
      description: >-
        Human sessions only. Every agent must pass the per-agent manageability
        check; one unmanageable agent rejects the whole request before any
        write. apply_focus sets sections and signal categories and keeps each
        agent's project, initiative, and column selections. reset deletes custom
        policies so agents inherit the organization default.
      operationId: bulk_update_agent_heartbeat_policies
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HeartbeatPolicyBulkRequest'
      responses:
        '200':
          description: Updated policy summaries
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HeartbeatPolicyBulkResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    HeartbeatPolicyBulkRequest:
      oneOf:
        - type: object
          additionalProperties: false
          required:
            - action
            - agent_ids
            - sections
            - signal_categories
          properties:
            action:
              type: string
              enum:
                - apply_focus
            agent_ids:
              type: array
              minItems: 1
              maxItems: 100
              items:
                type: string
                format: uuid
            sections: 6bc704ea-954e-41e2-bc03-c4147c225648
            signal_categories: 972ff7a2-e4b3-44ad-a5bf-fc3ffa8598e4
        - type: object
          additionalProperties: false
          required:
            - action
            - agent_ids
          properties:
            action:
              type: string
              enum:
                - reset
            agent_ids:
              type: array
              minItems: 1
              maxItems: 100
              items:
                type: string
                format: uuid
    HeartbeatPolicyBulkResponse:
      type: object
      required:
        - action
        - agent_ids
        - summaries
      properties:
        action:
          type: string
          enum:
            - apply_focus
            - reset
        agent_ids:
          type: array
          items:
            type: string
            format: uuid
        summaries:
          type: array
          items:
            type: object
            required:
              - agent_member_id
              - status
              - effective_policy
            properties:
              agent_member_id:
                type: string
                format: uuid
              status:
                type: string
                enum:
                  - default
                  - customized
              effective_policy:
                $ref: '#/components/schemas/HeartbeatPolicyInput'
    HeartbeatPolicyInput:
      type: object
      additionalProperties: false
      required:
        - sections
        - signal_categories
        - project_ids
        - initiative_ids
        - columns
      properties:
        sections:
          type: object
          additionalProperties: false
          required:
            - goals
            - standalone_kpis
            - standalone_initiatives
            - assigned_issues
            - project_context
            - signals
            - attention
          properties:
            goals:
              type: boolean
            standalone_kpis:
              type: boolean
            standalone_initiatives:
              type: boolean
            assigned_issues:
              type: boolean
            project_context:
              type: boolean
            signals:
              type: boolean
            attention:
              type: boolean
        signal_categories:
          type: object
          additionalProperties: false
          required:
            - task
            - initiative
            - kpi
            - project
          properties:
            task:
              type: boolean
            initiative:
              type: boolean
            kpi:
              type: boolean
            project:
              type: boolean
        project_ids:
          type: array
          items:
            type: string
            format: uuid
        initiative_ids:
          type: array
          items:
            type: string
            format: uuid
        columns:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
              - project_id
              - column_id
            properties:
              project_id:
                type: string
                format: uuid
              column_id:
                type: string
                format: uuid
    Error:
      type: object
      description: >-
        Common error responses contain error. Shared missing-auth and
        unknown-API responses also contain a stable code.
      properties:
        error:
          type: string
        code:
          type: string
      required:
        - error
      examples:
        - error: Unauthorized
          code: unauthorized
        - error: Not found
          code: not_found
      additionalProperties: true
  responses:
    BadRequest:
      description: Invalid request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Missing or invalid authentication
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Authenticated but not allowed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found or not visible
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: sk_atoll_<key>

````

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