---
title: "Get agent version by name"
method: GET
path: "/agent-version/{name}"
tags: ["agent-version"]
---

# Get agent version by name

`GET /agent-version/{name}`

## Path parameters

- `name` string, required

## Response `200`

OK

- ModelAgentVersionResponse
  - `agentVersion` ModelAgentVersion
    - `apiVersion` string
    - `kind` 'Configuration' | 'Agent' | 'AgentType' | 'AgentVersion' | 'Source' | 'Processor' | 'Connector' | 'Destination' | 'Extension' | 'SourceType' | 'ProcessorType' | 'ConnectorType' | 'DestinationType' | 'ExtensionType' | 'RecommendationType' | 'Unknown' | 'Rollout' | 'RolloutType' | 'Organization' | 'Account' | 'Invitation' | 'Login' | 'User' | 'AccountOrganizationBinding' | 'UserOrganizationBinding' | 'UserAccountBinding' | 'AuditTrail' | 'AvailableComponents' | 'SecretsManagerType' | 'SecretsManager' | 'Recording' | 'Credential' | 'CredentialType' | 'Fleet' | 'Integration' | 'IntegrationType' | 'ConfigurationType' | 'Notification' | 'Recommendation' | 'PublicProcessor' | 'Blueprint' | 'PrometheusRule' | 'APIKey' | 'ResourcePreset'
    - `metadata` ModelMetadata
      - `additionalInfo` ModelAdditionalInfo
        - `documentation` ModelDocumentationLink[]
          - `text` string
          - `url` string
        - `message` string
      - `blueprintTags` ModelBlueprintTags
      - `dateModified` string
      - `deprecated` boolean — Deprecated indicates that this resource is deprecated and should not be used. Deprecated resources should contain additional information about why the resource is deprecated and what should be used instead. Note: Ironically, the Deprecated field is itself deprecated. Use Stability instead.
      - `description` string
      - `displayName` string
      - `hash` string — Hash is a hex formatted sha256 Hash of the json-encoded spec that is used to determine if the spec has changed.
      - `icon` string
      - `id` string
      - `labels` ModelLabels
      - `name` string
      - `resourceDocLink` string
      - `stability` 'development' | 'alpha' | 'beta' | 'stable' | 'deprecated' | 'legacy' | ''
      - `version` integer — Version is a 1-based integer that is incremented each time the spec is changed.
      - `warning` string — Warning is an optional message that is displayed to the user when the resource is configured. Currently used for IntegrationTypes.
    - `spec` ModelAgentVersionSpec
      - `download` object — Map of platform to download URL and hash
      - `draft` boolean
      - `installer` object — Map of platform to installer script URL
      - `prerelease` boolean
      - `releaseDate` string — ReleaseDate is an RFC3339 encoded date in a string
      - `releaseNotesURL` string
      - `type` string
      - `version` string
    - `status` ModelNoStatus

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/bindplane/apis/docs-bindplane-com.md) · [All operations](https://skmtc.dev/bindplane/apis/docs-bindplane-com/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bindplane/docs-bindplane-com/revisions/bfcb7e57121c/schema)