Environments¶
Your integration needs three pieces of environment-specific information before it can call the API:
- The beta base URL
- An integration credential
- An account with available balance in that environment
Base URL¶
The current beta base URL is:
https://app.vulnetic.ai/api/v1
Examples:
https://app.vulnetic.ai/api/v1/me
https://app.vulnetic.ai/api/v1/projects
https://app.vulnetic.ai/api/v1/sessions
Recommended environment table¶
Before public release, populate this page with the real hostnames you want customers to use.
| Environment | Purpose | What to publish |
|---|---|---|
| Production beta | Live beta integrations and billable usage | https://app.vulnetic.ai/api/v1, account requirements, and support contact |
| Test or Sandbox | Safe integration testing | Exact base URL, data reset behavior, and any usage limitations |
| Internal or Preview | Pre-release validation | Whether this environment is supported or internal-only |
Operational notes¶
- Usage runs against the balance of the account attached to the integration identity
- UUIDs are used across resource identifiers such as projects, sessions, findings, and documents
- Timestamps in the schema are RFC 3339
date-timevalues - The list endpoints support pagination and, in some cases, sorting and filtering
OpenAPI gap¶
Warning
The current OpenAPI file does not define a servers array. These docs use the current beta host https://app.vulnetic.ai/api/v1, but the final public contract should still publish the server list directly.