Cloudsek Events API

openapi: 3.2.0
info:
  title: Cloudsek Events API
  version: '2026-10-09'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-09: 11 operation(s) read from 16 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Cloudsek has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 11
    pages-with-code: 0
    pages-read: 16
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-09'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://api.cloudsek.com/docs/api/bulk-jobs
  - https://api.cloudsek.com/docs/api/get-alerts
  - https://api.cloudsek.com/docs/api/patch-event
  - https://api.cloudsek.com/docs/api/events-write
  - https://api.cloudsek.com/docs/api/get-alerts-v-2
  - https://api.cloudsek.com/docs/api/patch-incident
  - https://api.cloudsek.com/docs/api/post-event-bulk
  - https://api.cloudsek.com/docs/api/get-event-snapshot
  - https://api.cloudsek.com/docs/api/post-event-comment
  - https://api.cloudsek.com/docs/api/post-incident-bulk
  - https://api.cloudsek.com/docs/api/get-historic-alerts
  - https://api.cloudsek.com/docs/api/patch-event-assignee
  - https://api.cloudsek.com/docs/api/post-event-remediate
  - https://api.cloudsek.com/docs/api/get-incident-snapshot
  - https://api.cloudsek.com/docs/api/post-incident-comment
  - https://api.cloudsek.com/docs/api/get-historic-alerts-v-2
security:
- Bearer_token: []
tags:
- name: Events
paths:
  /v2/events/{id}/assignee:
    patch:
      operationId: patch_v2_events_id_assignee
      tags:
      - Events
      summary: Reassign an event to a user (by email)
      x-source: https://api.cloudsek.com/docs/api/patch-event-assignee
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchV2EventsIdAssigneeRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v2/events/{id}/{idid}:
    post:
      operationId: post_v2_events_id_idid
      tags:
      - Events
      summary: Remediate an event (Closed* transition + closure narrative)
      description: 'Triggers the event''s remediation flow: a transition to a Closed* status combined with a comment. Includes the same rescan-redirect handling as PATCH /v2/events/{id}. The closure comment is always written. Returns the new comment_id or prior operation_id on identical remediation.'
      x-source: https://api.cloudsek.com/docs/api/post-event-remediate
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: idid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
        collapsed_from: 2 example path(s) differing only at idId
components:
  schemas:
    PatchV2EventsIdAssigneeRequest:
      type: object
      properties:
        assignee_email:
          type: string
          description: Email of the user to assign the event to; set to null to unassign.
  securitySchemes:
    Bearer_token:
      type: http
      scheme: bearer
      x-source: https://api.cloudsek.com/docs/intro/