Skip to main content
ZStack
Infrastructure/Agent Plugins

GetPlugin

Retrieve a single plugin by its unique identifier

GET/api/v1/plugins/{pluginId}

Operation ID

GetPlugin

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • pluginId
    StringRequired

    Unique identifier of the plugin to retrieve

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • id
    String

    Unique identifier of the plugin

    Example: plugin-001-abc

  • name
    String

    Human-readable name of the plugin

    Example: nginx-log-collector

  • version
    String

    Version of the plugin package

    Example: 2.1.0

  • pluginType
    String

    Plugin type category (e.g. log, metric, trace)

    Example: log

  • artifactUrl
    String

    Download URL of the plugin binary artifact

    Example: https://artifacts.example.com/plugins/nginx-log-collector-2.1.0.tar.gz

  • checksum
    String

    SHA256 checksum of the plugin artifact

    Example: sha256:abc123def456

  • configSchema
    String

    JSON schema string for plugin configuration

    Example: {}

  • pluginRuntime
    String

    Runtime environment required by the plugin (e.g. go, python)

    Example: go

  • registeredAt
    String

    Registered at

    Example: 2026-01-15T08:00:00Z