Open maximpn opened 1 month ago
Pinging @elastic/security-threat-hunting (Team:Threat Hunting)
Pinging @elastic/security-solution (Team: SecuritySolution)
Pinging @elastic/security-threat-hunting-investigations (Team:Threat Hunting:Investigations)
Epic: https://github.com/elastic/security-team/issues/9524 Depends on: https://github.com/elastic/kibana/issues/183810, https://github.com/elastic/kibana/issues/183812
Deadline: Sep 24, 2024 (see milestones in https://github.com/elastic/security-team/issues/9400)
Summary
As part of the Serverless project, we need to make sure OpenAPI specs for all public Timeline API endpoints are polished and ready to be published on a documentation website. Please look for more context in the epic, and please find below what needs to be done exactly.
API endpoints
The following public API endpoints were discovered during research:
POST /api/timeline
PATCH /api/timeline
POST /api/timeline/_import
POST /api/timeline/_export
GET /api/timeline/_draft
GET /api/timeline
GET /api/timeline/resolve
GET /api/timelines
POST /api/timeline/_draft
DELETE /api/timeline
PATCH /api/timeline/_favorite
POST /api/timeline/_prepackaged
PATCH /api/note
DELETE /api/note
PATCH /api/pinned_event
To do
For all the Timeline API endpoints (including those above), in the corresponding OpenAPI specification files, please:
Ask @maximpn to provide you with an example of a polished and documentation-ready OpenAPI spec. Please also ask @maximpn for a link to the generated API reference documentation (at the time of creating this ticket, it didn't exist).