Skip to main content
POST
Create Vault Integration

Overview

Registers an external secret-manager integration. v1 supports HashiCorp Vault (OSS, Enterprise, and OpenBao) via AppRole authentication. ScrapEngine never stores the raw username/password — instead, you point credentials at this integration and a vault path, and the authenticate task action reads the secret on demand using the registered AppRole. The secret_id is stored encrypted at rest.

Body

string
required
Human-readable name. 1-100 characters.
string
required
Backend type. Must be hashicorp (only value supported in v1).
object
required
HashiCorp-specific configuration.

Example Request

Response

Success Response (201)

string
Integration ID (UUID). Reference from credential records.
string
The name you provided.
string
Always hashicorp in v1.
string
Vault address.
string
Vault Enterprise namespace, or null if unset.
string
Always approle in v1.
string
AppRole role_id (echoed back; secret_id is never returned).
string
ISO 8601 timestamp.
string
ISO 8601 timestamp.
Example Response:

Error Responses