Pynt

Pynt Scan Schedule API

The scan-schedule API from Pynt — 4 operation(s) for scan-schedule.

GitHub OpenAPI
Business capability
Vulnerability Management BC-620.40

Operations 6

POST /v1/application/{application_id}/scan-schedule Create Scan Schedule #
GET /v1/application/{application_id}/scan-schedule Get Scan Schedule By Application #
PATCH /v1/application/{application_id}/scan-schedule/{scan_schedule_id} Update Scan Schedule #
DELETE /v1/application/{application_id}/scan-schedule/{scan_schedule_id} Delete Scan Schedule #
PATCH /v1/application/{application_id}/scan-schedule/{scan_schedule_id}/state Update Scan Schedule State #
GET /v1/scan-schedule List All Scan Schedules #

Documentation

📖
APIReference
https://api.pynt.io/docs
📖
Documentation
https://docs.pynt.io/documentation

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/pynt/refs/heads/main/openapi/pynt-scan-schedule-api-openapi.yml

Other Resources

🔗
MCPCandidate
https://raw.githubusercontent.com/api-evangelist/pynt/refs/heads/main/mcp/pynt-mcp.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/pynt-scan-schedule-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

pynt-scan-schedule-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Pynt Scan Schedule API
  version: 0.1.0
  description: 'Operations tagged scan-schedule across 2 of this provider''s published API definitions: pynt-openapi.json, pynt-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.pynt.io
  description: Pynt production API
tags:
- name: scan-schedule
paths:
  /v1/application/{application_id}/scan-schedule:
    post:
      tags:
      - scan-schedule
      summary: Create Scan Schedule
      operationId: create_scan_schedule_v1_application__application_id__scan_schedule_post
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
      parameters:
      - name: application_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Application Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateScanScheduleRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScanScheduleOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - scan-schedule
      summary: Get Scan Schedule By Application
      operationId: get_scan_schedule_by_application_v1_application__application_id__scan_schedule_get
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
      parameters:
      - name: application_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Application Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScanScheduleOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/application/{application_id}/scan-schedule/{scan_schedule_id}:
    patch:
      tags:
      - scan-schedule
      summary: Update Scan Schedule
      operationId: update_scan_schedule_v1_application__application_id__scan_schedule__scan_schedule_id__patch
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
      parameters:
      - name: application_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Application Id
      - name: scan_schedule_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Scan Schedule Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateScanScheduleRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScanScheduleOut'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - scan-schedule
      summary: Delete Scan Schedule
      operationId: delete_scan_schedule_v1_application__application_id__scan_schedule__scan_schedule_id__delete
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
      parameters:
      - name: application_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Application Id
      - name: scan_schedule_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Scan Schedule Id
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/application/{application_id}/scan-schedule/{scan_schedule_id}/state:
    patch:
      tags:
      - scan-schedule
      summary: Update Scan Schedule State
      operationId: update_scan_schedule_state_v1_application__application_id__scan_schedule__scan_schedule_id__state_patch
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
      parameters:
      - name: application_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Application Id
      - name: scan_schedule_id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
          title: Scan Schedule Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateScanScheduleStateRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/scan-schedule:
    get:
      tags:
      - scan-schedule
      summary: List All Scan Schedules
      operationId: list_all_scan_schedules_v1_scan_schedule_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ScanScheduleOut'
                type: array
                title: Response List All Scan Schedules V1 Scan Schedule Get
      security:
      - Bearer Token: []
      - Operator Organization Context: []
      - API Key: []
      - Bearer Token: []
      - System API Key: []
      - Organization ID: []
components:
  schemas:
    UpdateScanScheduleStateRequest:
      properties:
        state:
          type: string
          enum:
          - active
          - paused
          title: State
      type: object
      required:
      - state
      title: UpdateScanScheduleStateRequest
    AppScanTargetOut:
      properties:
        integration_type:
          type: string
          const: app
          title: Integration Type
          default: app
      type: object
      title: AppScanTargetOut
      description: 'Scan target for a Pynt application''s built collection.


        The client supplies only the integration type; the collection''s S3 location

        is derived server-side from the application''s assigned poid.'
    OnlyOnceSpec:
      properties:
        schedule_type:
          type: string
          const: only_once
          title: Schedule Type
          default: only_once
        run_at:
          type: string
          format: date-time
          title: Run At
      type: object
      required:
      - run_at
      title: OnlyOnceSpec
    NewmanScanTargetOut:
      properties:
        integration_type:
          type: string
          const: newman
          title: Integration Type
          default: newman
        collection_to_test:
          type: string
          minLength: 1
          title: Collection To Test
        environment_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Environment Name
        api_key:
          type: string
          minLength: 1
          title: Api Key
      type: object
      required:
      - collection_to_test
      - api_key
      title: NewmanScanTargetOut
    CreateDayOfWeekSpec:
      properties:
        time_local:
          type: string
          format: time
          title: Time Local
        schedule_type:
          type: string
          const: day_of_week
          title: Schedule Type
          default: day_of_week
        days:
          items:
            $ref: '#/components/schemas/DayOfWeek'
          type: array
          minItems: 1
          title: Days
      type: object
      required:
      - time_local
      - days
      title: CreateDayOfWeekSpec
    SyncStatus:
      type: string
      enum:
      - pending
      - synced
      - failed
      title: SyncStatus
    DayOfWeek:
      type: string
      enum:
      - sunday
      - monday
      - tuesday
      - wednesday
      - thursday
      - friday
      - saturday
      title: DayOfWeek
    HarScanTargetOut:
      properties:
        integration_type:
          type: string
          const: har
          title: Integration Type
          default: har
        har_path:
          type: string
          minLength: 1
          title: Har Path
        capture_domains:
          anyOf:
          - type: string
          - type: 'null'
          title: Capture Domains
      type: object
      required:
      - har_path
      title: HarScanTargetOut
    CreateScanScheduleRequest:
      properties:
        spec:
          oneOf:
          - $ref: '#/components/schemas/CreateDayOfWeekSpec'
          - $ref: '#/components/schemas/CreateDayIntervalSpec'
          - $ref: '#/components/schemas/CreateOnlyOnceSpec'
          title: Spec
          discriminator:
            propertyName: schedule_type
            mapping:
              day_interval: '#/components/schemas/CreateDayIntervalSpec'
              day_of_week: '#/components/schemas/CreateDayOfWeekSpec'
              only_once: '#/components/schemas/CreateOnlyOnceSpec'
        target:
          oneOf:
          - $ref: '#/components/schemas/HarScanTargetOut'
          - $ref: '#/components/schemas/NewmanScanTargetOut'
          - $ref: '#/components/schemas/AppScanTargetOut'
          title: Target
          discriminator:
            propertyName: integration_type
            mapping:
              app: '#/components/schemas/AppScanTargetOut'
              har: '#/components/schemas/HarScanTargetOut'
              newman: '#/components/schemas/NewmanScanTargetOut'
      type: object
      required:
      - spec
      - target
      title: CreateScanScheduleRequest
    CreateDayIntervalSpec:
      properties:
        time_local:
          type: string
          format: time
          title: Time Local
        schedule_type:
          type: string
          const: day_interval
          title: Schedule Type
          default: day_interval
        interval_days:
          type: integer
          minimum: 1.0
          title: Interval Days
      type: object
      required:
      - time_local
      - interval_days
      title: CreateDayIntervalSpec
    UpdateScanScheduleRequest:
      properties:
        spec:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/DayOfWeekSpec-Input'
            - $ref: '#/components/schemas/DayIntervalSpec-Input'
            - $ref: '#/components/schemas/OnlyOnceSpec'
            discriminator:
              propertyName: schedule_type
              mapping:
                day_interval: '#/components/schemas/DayIntervalSpec-Input'
                day_of_week: '#/components/schemas/DayOfWeekSpec-Input'
                only_once: '#/components/schemas/OnlyOnceSpec'
          - type: 'null'
          title: Spec
        target:
          anyOf:
          - oneOf:
            - $ref: '#/components/schemas/HarScanTargetOut'
            - $ref: '#/components/schemas/NewmanScanTargetOut'
            - $ref: '#/components/schemas/AppScanTargetOut'
            discriminator:
              propertyName: integration_type
              mapping:
                app: '#/components/schemas/AppScanTargetOut'
                har: '#/components/schemas/HarScanTargetOut'
                newman: '#/components/schemas/NewmanScanTargetOut'
          - type: 'null'
          title: Target
      type: object
      title: UpdateScanScheduleRequest
    DayOfWeekSpec-Output:
      properties:
        schedule_type:
          type: string
          const: day_of_week
          title: Schedule Type
          default: day_of_week
        days:
          items:
            $ref: '#/components/schemas/DayOfWeek'
          type: array
          minItems: 1
          title: Days
        time_utc:
          type: string
          title: Time Utc
      type: object
      required:
      - days
      - time_utc
      title: DayOfWeekSpec
    ScanScheduleOut:
      properties:
        scan_schedule_id:
          type: string
          title: Scan Schedule Id
        application_id:
          type: string
          title: Application Id
        created_at:
          type: string
          format: date-time
          title: Created At
        spec:
          oneOf:
          - $ref: '#/components/schemas/DayOfWeekSpec-Output'
          - $ref: '#/components/schemas/DayIntervalSpec-Output'
          - $ref: '#/components/schemas/OnlyOnceSpec'
          title: Spec
          discriminator:
            propertyName: schedule_type
            mapping:
              day_interval: '#/components/schemas/DayIntervalSpec-Output'
              day_of_week: '#/components/schemas/DayOfWeekSpec-Output'
              only_once: '#/components/schemas/OnlyOnceSpec'
        target:
          oneOf:
          - $ref: '#/components/schemas/HarScanTargetOut'
          - $ref: '#/components/schemas/NewmanScanTargetOut'
          - $ref: '#/components/schemas/AppScanTargetOut'
          title: Target
          discriminator:
            propertyName: integration_type
            mapping:
              app: '#/components/schemas/AppScanTargetOut'
              har: '#/components/schemas/HarScanTargetOut'
              newman: '#/components/schemas/NewmanScanTargetOut'
        state:
          $ref: '#/components/schemas/ScheduleState'
        sync_status:
          $ref: '#/components/schemas/SyncStatus'
      type: object
      required:
      - scan_schedule_id
      - application_id
      - created_at
      - spec
      - target
      - state
      - sync_status
      title: ScanScheduleOut
    DayOfWeekSpec-Input:
      properties:
        schedule_type:
          type: string
          const: day_of_week
          title: Schedule Type
          default: day_of_week
        days:
          items:
            $ref: '#/components/schemas/DayOfWeek'
          type: array
          minItems: 1
          title: Days
        time_utc:
          type: string
          format: time
          title: Time Utc
      type: object
      required:
      - days
      - time_utc
      title: DayOfWeekSpec
    CreateOnlyOnceSpec:
      properties:
        schedule_type:
          type: string
          const: only_once
          title: Schedule Type
          default: only_once
        run_at:
          type: string
          format: date-time
          title: Run At
      type: object
      required:
      - run_at
      title: CreateOnlyOnceSpec
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    DayIntervalSpec-Input:
      properties:
        schedule_type:
          type: string
          const: day_interval
          title: Schedule Type
          default: day_interval
        interval_days:
          type: integer
          minimum: 1.0
          title: Interval Days
        time_utc:
          type: string
          format: time
          title: Time Utc
      type: object
      required:
      - interval_days
      - time_utc
      title: DayIntervalSpec
    DayIntervalSpec-Output:
      properties:
        schedule_type:
          type: string
          const: day_interval
          title: Schedule Type
          default: day_interval
        interval_days:
          type: integer
          minimum: 1.0
          title: Interval Days
        time_utc:
          type: string
          title: Time Utc
      type: object
      required:
      - interval_days
      - time_utc
      title: DayIntervalSpec
    ScheduleState:
      type: string
      enum:
      - active
      - paused
      - completed
      title: ScheduleState
  securitySchemes:
    API_Key:
      type: apiKey
      in: header
      name: X-API-Key
    Bearer_Token:
      type: apiKey
      in: header
      name: Authorization
    System_API_Key:
      type: apiKey
      in: header
      name: X-System-API-Key
    Organization_ID:
      type: apiKey
      in: header
      name: X-Organization-ID
    Operator_Organization_Context:
      type: apiKey
      in: header
      name: context
x-refined-from:
- pynt-openapi.json
- pynt-openapi.json