Skip to content

feat(developer): rewrite API quickstart as a Getting Started guide#2962

Open
StephKll3c wants to merge 4 commits into
mainfrom
feat/api-getting-started
Open

feat(developer): rewrite API quickstart as a Getting Started guide#2962
StephKll3c wants to merge 4 commits into
mainfrom
feat/api-getting-started

Conversation

@StephKll3c
Copy link
Copy Markdown
Contributor

@StephKll3c StephKll3c commented Apr 30, 2026

Summary

  • Replace the existing quickstart with a structured, step-by-step Getting Started guide
  • Covers: API key creation, first API call (GET /v1/me), region selection, and common error codes (401/403/429)
  • Remove advanced content (pagination, Python scripts, event search) that does not belong in a Getting Started page

Replace the dense reference-style quickstart with a step-by-step guide
covering API key creation, a first API call, region selection, and
common error codes. Remove advanced content (pagination, Python scripts,
event search) that does not belong in a Getting Started page.
Add a tutorials index page with Material grid cards linking to three
step-by-step guides: filtering rules (GET), creating a SIGMA rule (POST),
and searching events (async job workflow). Update mkdocs.yml nav accordingly.
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 30, 2026

Newest code from StephKll3c has been published to preview environment

🚀 Latest deployment was built on 2026-04-30 08:38:47 (8c9808f8271eb66872440b9d6d9b66a3a4af24d8).

…steps

Move base URL step before the first API call to avoid region confusion.
Use an environment variable in the curl example. Replace the vague 'Next
steps' with direct links to the tutorials section.
| `enabled` | Whether the rule is active | `true` |

## Create the rule

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Write a short intro and/or steps to let the user know how to use this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants