Britive platform release 2026.09.02 is now live in production.

Get CSPM integration details (without token)

Prev Next
Get
/api/cspm/integrations/{name}

Returns the stored details for the given CSPM integration, including its ingest URL. The token itself is never returned after creation.

Security
HTTP
Type bearer
Path parameters
name
stringRequired

Either the unique, tenant-wide name given to this integration at creation, or its generated id ("cspm-"). The id is tried first (a direct lookup); if it doesn't match, the value is looked up as a name.

Responses
200

CSPM integration details

object

Stored details for a single CSPM integration (token not included)

app
string

CSPM application type

name
string

Unique, tenant-wide name given to this integration at creation

description
string

Description of this integration

ingestUrl
string

URL to which CSPM events should be sent (/-ingest/)

createdOn
string

Timestamp when the active token was created. Updated on each rotation -- it tracks the token, not the integration record -- so this reflects when the token was last rotated, not necessarily when the integration itself was first created.

actionTemplate
string

The app's outbound webhook payload/action template (e.g. Wiz's Mustache-syntax action template), to be pasted as-is into the CSPM tool's own webhook/action configuration so the events it sends match the shape this integration ingests. Identical for every integration of a given app type -- not customized per integration. Absent if the app has no such template. Also always absent on List all CSPM integrations (the list response) -- it's only included when a single integration is returned (Get/Update CSPM integration details), since repeating an identical value on every list row would be wasted payload.

404

No integration found with the given name or id