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

# Remove Schedule Authorizers

> Remove authorizers from a scheduled balance request

# Remove Schedule Authorizers

Remove specific authorizers from an existing scheduled balance request. The schedule will continue running for any remaining authorizers.

## Use Cases

* Stop monitoring specific accounts while keeping the schedule active for others
* Clean up authorizers that are no longer needed
* Reduce the scope of an existing schedule without recreating it

## Response Fields

| Field             | Description                                                  |
| ----------------- | ------------------------------------------------------------ |
| `removed_count`   | Number of authorizers successfully removed from the schedule |
| `remaining_count` | Number of authorizers still in the schedule after removal    |


## OpenAPI

````yaml PATCH /v1/monitoring/schedules/{id}/authorizers
openapi: 3.1.0
info:
  title: Rightfoot API
  description: >-
    Submit a batch of authorizers for balance checks, retrieve processed
    balances, and check the status of a batch.
  version: 0.3.0-alpha
servers:
  - url: https://api.rightfoot.com
security:
  - BearerAuth: []
tags:
  - name: General Availability
    description: |
      **General Availability** indicates that the endpoint is production-ready.
  - name: Early Access
    description: >
      **Early Access** indicates that the endpoint is available for early access
      customers and is being actively refined.
  - name: In Development
    description: >
      **In Development** indicates that the endpoint is currently being built
      and will be available in an upcoming release.
paths:
  /v1/monitoring/schedules/{id}/authorizers:
    patch:
      tags:
        - General Availability
      summary: Remove authorizers from a schedule
      description: >
        Remove specific authorizers from an existing scheduled balance request.
        The schedule will continue running for any remaining authorizers.
      operationId: remove_schedule_authorizers
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            The schedule ID (UUID) returned when creating the scheduled balance
            request.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                authorizer_unique_ids:
                  type: array
                  items:
                    type: string
                  description: List of authorizer unique IDs to remove from the schedule.
              required:
                - authorizer_unique_ids
            example:
              authorizer_unique_ids:
                - auth-123
                - auth-456
                - auth-789
      responses:
        '200':
          description: Authorizers removed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RemoveScheduleAuthorizersResponse'
              example:
                removed_count: 3
                remaining_count: 147
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
              example:
                status: error
                status_code: 404
                error:
                  code: NOT_FOUND
                  message: Schedule not found.
                  timestamp: '2024-12-12T12:00:00Z'
                  suggestion: Please check the schedule ID.
                documentation_url: https://api.rightfoot.com/docs
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    RemoveScheduleAuthorizersResponse:
      type: object
      properties:
        removed_count:
          type: integer
          description: Number of authorizers successfully removed from the schedule.
        remaining_count:
          type: integer
          description: Number of authorizers still in the schedule after removal.
      required:
        - removed_count
        - remaining_count
    ApiErrorResponse:
      type: object
      properties:
        status:
          type: string
          description: Status of the error, either "error" or "success"
        status_code:
          type: integer
          description: HTTP status code of the error
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code (e.g., "RESOURCE_NOT_FOUND")
            message:
              type: string
              description: Detailed error message.
            details:
              type: string
              description: Additional details about the error
            timestamp:
              type: string
              format: date-time
              description: Time the error occurred
            suggestion:
              type: string
              description: Suggested action to resolve the error
        documentation_url:
          type: string
          format: uri
          description: URL to the documentation for the error
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: error
            status_code: 401
            error:
              code: UNAUTHORIZED
              message: Invalid API key provided.
              timestamp: '2024-09-16T12:01:00Z'
              suggestion: Please check your API key.
            documentation_url: https://api.rightfoot.com/docs
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: error
            status_code: 500
            error:
              code: INTERNAL_SERVER_ERROR
              message: An unexpected error occurred while retrieving the balances.
              timestamp: '2024-09-16T12:11:00Z'
              suggestion: >-
                Please try again later. If the problem persists, contact our
                support team.
            documentation_url: https://api.rightfoot.com/docs
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        Authentication to the API is performed via Bearer Token Authentication.
        Provide your API key as the bearer token in the Authorization header.


        All API requests must be made over HTTPS. Calls made over plain HTTP
        will fail. API requests without authentication will also fail.

````