Palo Alto Networks

Palo Alto Networks Peripherals API

The Peripherals API from Palo Alto Networks — 2 operation(s) for peripherals.

GitHub OpenAPI
Business capability
Cybersecurity Management BC-620

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/api/peripherals List peripheral devices · List Peripherals #
Ask an LLM
“Which peripheral devices are registered for my tenant?”
“Can I filter peripherals by type and include their groups?”
Tell an agent
List peripherals of type {peripheral_type}.
Show page {page} of my peripherals with groups included {with_groups}.
POST /v2/api/peripherals Create a peripheral device · Create Peripheral #
Ask an LLM
“How do I register a new peripheral device?”
“What type values can a new peripheral have?”
Tell an agent
Create a peripheral of type {type}.
Register a new {type} peripheral for my tenant.
DELETE /v2/api/peripherals/{resourceId} Delete a peripheral device · Delete Peripheral #
Ask an LLM
“How do I remove a peripheral device?”
“Can I delete a peripheral by its ID?”
Tell an agent destructive · confirm first
Delete peripheral {resource_id}.
Remove peripheral device {resource_id} from my tenant.
GET /v2/api/peripherals/{resourceId} Get a peripheral device · Get Peripheral #
Ask an LLM
“What are the details of one peripheral device?”
“Can I fetch a peripheral by its resource ID?”
Tell an agent
Get peripheral {resource_id}.
Show me the details of peripheral device {resource_id}.
PUT /v2/api/peripherals/{resourceId} Replace a peripheral device · Update Peripheral #
Ask an LLM
“Can I change an existing peripheral's type?”
“Does updating a peripheral replace the whole record?”
Tell an agent
Replace peripheral {resource_id} with type {type}.
Update peripheral device {resource_id} to be a {type}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/palo-alto-networks/refs/heads/main/openapi/palo-alto-networks-peripherals-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/palo-alto-networks:palo-alto-networks-peripherals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

palo-alto-networks-peripherals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact: {}
  description: 'Manage peripheral device configurations and policies for DLP protection. Configure USB devices, printers,

    and other peripherals to enforce DLP policies and prevent unauthorized data transfers.'
  license:
    name: MIT
    url: https://opensource.org/license/mit
  title: v2 Peripherals API
  version: 1.0.0
servers:
- url: https://api.dlp.paloaltonetworks.com
tags:
- name: Peripherals
paths:
  /v2/api/peripherals:
    get:
      description: Returns a paginated list of peripheral devices for the authenticated tenant.
      operationId: get-v2-api-peripherals
      parameters:
      - description: Zero-based page index (0..N)
        in: query
        name: page
        required: false
        schema:
          default: 0
          minimum: 0
          type: integer
      - description: The size of the page to be returned
        in: query
        name: size
        required: false
        schema:
          default: 20
          minimum: 1
          type: integer
      - description: 'Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.'
        in: query
        name: sort
        required: false
        schema:
          items:
            type: string
          type: array
      - description: Comma-separated list of peripheral types to filter (usb, printer, network_share)
        in: query
        name: peripheral-type
        schema:
          type: string
      - description: If true, include group membership information
        in: query
        name: with-groups
        schema:
          type: boolean
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagePeripheralResponse'
          description: Paginated list of peripherals
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - insufficient privileges
      security:
      - Bearer: []
      summary: List Peripherals
      tags:
      - Peripherals
    post:
      description: Creates a new peripheral device for the authenticated tenant.
      operationId: post-v2-api-peripherals
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PeripheralRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeripheralResponse'
          description: Peripheral created
        '400':
          description: Invalid request payload
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - insufficient privileges
      security:
      - Bearer: []
      summary: Create Peripheral
      tags:
      - Peripherals
  /v2/api/peripherals/{resourceId}:
    delete:
      description: Deletes a peripheral device by its ID.
      operationId: delete-v2-api-peripherals-resourceid
      parameters:
      - in: path
        name: resourceId
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Peripheral deleted
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - insufficient privileges
        '404':
          description: Peripheral not found
      security:
      - Bearer: []
      summary: Delete Peripheral
      tags:
      - Peripherals
    get:
      description: Retrieves a single peripheral device by its ID.
      operationId: get-v2-api-peripherals-resourceid
      parameters:
      - in: path
        name: resourceId
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeripheralResponse'
          description: Peripheral found
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - insufficient privileges
        '404':
          description: Peripheral not found
      security:
      - Bearer: []
      summary: Get Peripheral
      tags:
      - Peripherals
    put:
      description: Fully replaces an existing peripheral device with the provided payload.
      operationId: put-v2-api-peripherals-resourceid
      parameters:
      - in: path
        name: resourceId
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PeripheralRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PeripheralResponse'
          description: Peripheral updated
        '400':
          description: Invalid request payload
        '401':
          description: Unauthorized
        '403':
          description: Forbidden - insufficient privileges
        '404':
          description: Peripheral not found
      security:
      - Bearer: []
      summary: Update Peripheral
      tags:
      - Peripherals
components:
  schemas:
    PageableObject:
      properties:
        offset:
          format: int64
          type: integer
        pageNumber:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        paged:
          type: boolean
        sort:
          $ref: '#/components/schemas/SortObject'
        unpaged:
          type: boolean
      type: object
    SortObject:
      properties:
        empty:
          type: boolean
        sorted:
          type: boolean
        unsorted:
          type: boolean
      type: object
    AuditResponse:
      description: Audit metadata tracking creation and last-update information
      properties:
        created_at:
          description: Timestamp when the resource was created
          format: date-time
          type: string
        created_by:
          description: Username or service that created the resource
          type: string
        updated_at:
          description: Timestamp when the resource was last updated
          format: date-time
          type: string
        updated_by:
          description: Username or service that last updated the resource
          type: string
      type: object
    PagePeripheralResponse:
      properties:
        content:
          items:
            $ref: '#/components/schemas/PeripheralResponse'
          type: array
        empty:
          type: boolean
        first:
          type: boolean
        last:
          type: boolean
        number:
          format: int32
          type: integer
        numberOfElements:
          format: int32
          type: integer
        pageable:
          $ref: '#/components/schemas/PageableObject'
        size:
          format: int32
          type: integer
        sort:
          $ref: '#/components/schemas/SortObject'
        totalElements:
          format: int64
          type: integer
        totalPages:
          format: int32
          type: integer
      type: object
    PrinterPeripheralRequest:
      allOf:
      - $ref: '#/components/schemas/PeripheralRequest'
      - properties:
          description:
            description: Optional description
            type: string
          ip_address:
            description: IP address of network printer
            type: string
          manufacturer_name:
            description: Device manufacturer name
            type: string
          model_name:
            description: Device model name
            type: string
          name:
            description: Display name
            maxLength: 128
            minLength: 1
            type: string
          printer_name:
            description: Printer share name or UNC path
            type: string
          printer_type:
            description: Printer type (e.g. local, network)
            type: string
          product_id:
            description: USB product ID
            type: string
          serial_number:
            description: Device serial number
            type: string
          type:
            description: Peripheral type discriminator — must be 'printer'
            enum:
            - usb
            - printer
            - network_share
            example: printer
            type: string
          vendor_id:
            description: USB vendor ID
            type: string
        type: object
      description: Printer peripheral device request. Use type='printer'.
      required:
      - name
      - printer_type
      - type
      type: object
    PeripheralResponse:
      description: Peripheral device resource returned by the API
      properties:
        audit_metadata:
          $ref: '#/components/schemas/AuditResponse'
        description:
          description: Optional description
          type: string
        directory_path:
          description: Directory path (for network share peripherals)
          type: string
        groups:
          description: Groups this peripheral belongs to
          items:
            description: Groups this peripheral belongs to
            type: string
          type: array
        id:
          description: Unique identifier of the peripheral
          type: string
        ip_address:
          description: IP address (for network printer peripherals)
          type: string
        manufacturer_name:
          description: Device manufacturer name
          type: string
        model_name:
          description: Device model name
          type: string
        name:
          description: Display name of the peripheral
          type: string
        printer_name:
          description: Printer share name (for printer peripherals)
          type: string
        printer_type:
          description: Printer type (for printer peripherals)
          type: string
        product_id:
          description: USB product ID (for USB/printer peripherals)
          type: string
        serial_number:
          description: Device serial number
          type: string
        server_address:
          description: Server hostname or IP (for network share peripherals)
          type: string
        type:
          description: 'Peripheral type: usb, printer, or network_share'
          enum:
          - usb
          - printer
          - network_share
          type: string
        vendor_id:
          description: USB vendor ID (for USB/printer peripherals)
          type: string
        version:
          description: Version number, incremented on each update
          format: int32
          type: integer
      type: object
    UsbPeripheralRequest:
      allOf:
      - $ref: '#/components/schemas/PeripheralRequest'
      - properties:
          description:
            description: Optional description
            type: string
          manufacturer_name:
            description: Device manufacturer name
            type: string
          model_name:
            description: Device model name
            type: string
          name:
            description: Display name
            maxLength: 128
            minLength: 1
            type: string
          product_id:
            description: USB product ID (e.g. c52b)
            type: string
          serial_number:
            description: Device serial number
            type: string
          type:
            description: Peripheral type discriminator — must be 'usb'
            enum:
            - usb
            - printer
            - network_share
            example: usb
            type: string
          vendor_id:
            description: USB vendor ID (e.g. 046d)
            type: string
        type: object
      description: USB peripheral device request. Use type='usb'.
      required:
      - name
      - type
      type: object
    PeripheralRequest:
      description: Request payload for creating or updating a peripheral device. Use 'type' to specify the subtype.
      discriminator:
        propertyName: type
      oneOf:
      - $ref: '#/components/schemas/UsbPeripheralRequest'
      - $ref: '#/components/schemas/PrinterPeripheralRequest'
      - $ref: '#/components/schemas/NetworkSharePeripheralRequest'
      properties:
        type:
          type: string
      required:
      - type
      type: object
    NetworkSharePeripheralRequest:
      allOf:
      - $ref: '#/components/schemas/PeripheralRequest'
      - properties:
          description:
            description: Optional description
            type: string
          directory_path:
            description: Directory path on the network share (e.g. /documents)
            type: string
          name:
            description: Display name
            maxLength: 128
            minLength: 1
            type: string
          server_address:
            description: Server hostname or IP address of the network share
            type: string
          type:
            description: Peripheral type discriminator — must be 'network_share'
            enum:
            - usb
            - printer
            - network_share
            example: network_share
            type: string
        type: object
      description: Network share peripheral device request. Use type='network_share'.
      required:
      - name
      - server_address
      - type
      type: object
  securitySchemes:
    Bearer:
      scheme: bearer
      type: http