openapi: 3.0.3
info:
title: watchTowr Platform Client Activity Log API
description: 'The watchTowr Platform Client API provides read and write access to your external attack surface managed by the watchTowr Preemptive Exposure Management platform: discovered assets (domains, subdomains, IP addresses and ranges, ports, containers, cloud storage, mobile applications, SaaS platforms and source code repositories), security findings, hunts, certificates, business units, points of interest, service listings, suspicious domains and the activity log. Data is retrieved over HTTPS using paginated list endpoints and authenticated with a per-tenant API bearer token. Reconstructed by API Evangelist from the official watchtowr/watchtowr-api-sdk (OpenAPI Generator) Python client.'
version: '1.0'
contact:
name: watchTowr
url: https://watchtowr.com
servers:
- url: https://{tenant}.{region}.watchtowr.io
description: Per-tenant watchTowr Platform instance
variables:
tenant:
default: your-tenant
description: Your watchTowr tenant name
region:
default: your-region
description: Your watchTowr region
security:
- bearerAuth: []
tags:
- name: Activity Log
paths:
/api/client/activity-log/list:
get:
tags:
- Activity Log
summary: List all activity logs
operationId: get_list_activity_logs
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/Unauthorized'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenResponse'
parameters:
- name: page
in: query
required: false
description: Pagination page. The default value is 1.
schema:
type: number
- name: page_size
in: query
required: false
description: Pagination size. The default value is 10 and the maximum is 30.
schema:
type: number
components:
schemas:
Unauthorized:
type: object
properties:
message:
type: string
example: Unauthenticated.
ForbiddenResponse:
type: object
properties:
message:
type: string
example: This action is unauthorized.
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key issued from the watchTowr Platform dashboard (Settings -> API Management / Integrations -> Client API), sent as a Bearer token.