---
title: "GET /{spaceId}/certificates/{id}/usages"
method: GET
path: "/{spaceId}/certificates/{id}/usages"
tags: ["Certificates"]
---

# GET /{spaceId}/certificates/{id}/usages

`GET /{spaceId}/certificates/{id}/usages`

Get the usages of a certificate

## Path parameters

- `spaceId` string, required
- `id` string, required

## Response `200`

The requested Certificate usages

- CertificateUsageResource
  - `DeploymentTargetUsages` MachineResource[]
    - `Architecture` string
    - `Endpoint` EndpointResource
      - `CommunicationStyle` 'None' | 'TentaclePassive' | 'TentacleActive' | 'Ssh' | 'OfflineDrop' | 'AzureWebApp' | 'Ftp' | 'AzureCloudService' | 'AzureServiceFabricCluster' | 'Kubernetes' | 'StepPackage' | 'KubernetesTentacle' | 'AwsEcsCluster' — This is for legacy support in client. Server no longer uses this for determining endpoint types, it uses DeploymentTargetType
      - `Id` string — Gets or sets a unique identifier for this resource.
      - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
      - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
      - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `EnvironmentIds` string[]
    - `HasLatestCalamari` boolean
    - `HealthStatus` 'Healthy' | 'Unavailable' | 'Unknown' | 'HasWarnings' | 'Unhealthy'
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `IsDisabled` boolean
    - `IsInProcess` boolean
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `MachinePolicyId` string
    - `Name` string
    - `OperatingSystem` string
    - `OperatingSystemVersion` string
    - `Roles` string[]
    - `ShellName` string
    - `ShellVersion` string
    - `SkipInitialHealthCheck` boolean
    - `Slug` string
    - `SpaceId` string
    - `StatusSummary` string
    - `TenantedDeploymentParticipation` 'Untenanted' | 'TenantedOrUntenanted' | 'Tenanted'
    - `TenantIds` string[]
    - `TenantTags` string[]
    - `Thumbprint` string
    - `Uri` string
  - `Id` string — Gets or sets a unique identifier for this resource.
  - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
  - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
  - `LibraryVariableSetUsages` LibraryVariableSetResource[]
    - `ContentType` 'Variables' | 'ScriptModule' — Describes the purpose of the variable set. Clients can use this to offer an editing experience appropriately.
    - `Description` string — Gets or sets a description of this variable set that explains the purpose of the variable set to other users. This field may contain markdown.
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `Name` string — Gets or sets the name of this variable set. This should be short, preferably 5-20 characters.
    - `SpaceId` string
    - `Templates` ActionTemplateParameterResource[] — Gets the variable templates.
      - `DefaultValue` PropertyValueResource
        - `IsSensitive` boolean
        - `SensitiveValue` SensitiveValue
          - `HasValue` boolean
          - `Hint` string
          - `NewValue` string
        - `Value` string
      - `DisplaySettings` object
      - `HelpText` string
      - `Id` string
      - `Label` string
      - `Name` string
    - `VariableSetId` string — Gets or sets the id of the associated variable set.
    - `Version` integer — Gets or sets the version number.
  - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
  - `ProjectUsages` ProjectResource[]
    - `AllowIgnoreChannelRules` boolean
    - `AutoCreateRelease` boolean
    - `AutoDeployReleaseOverrides` AutoDeployReleaseOverrideResource[]
      - `EnvironmentId` string
      - `ReleaseId` string
      - `TenantId` string
    - `ClonedFromProjectId` string
    - `CombineHealthAndSyncStatusInDashboardLiveStatus` boolean
    - `DefaultGuidedFailureMode` 'EnvironmentDefault' | 'Off' | 'On'
    - `DefaultPowerShellEdition` string
    - `DefaultToSkipIfAlreadyInstalled` boolean
    - `DeploymentChangesTemplate` string
    - `DeploymentProcessId` string
    - `DeprovisioningRunbookId` string
    - `Description` string
    - `DiscreteChannelRelease` boolean — Treats releases of different channels to the same environment as a seperate deployment dimension. 'False' indicates a "hotfix"-style usage of channels (single release active per environment ignoring channels), whereas `True` indicates "microservice"-style usage (single release per environment per channel)
    - `ExecuteDeploymentsOnEventBasedPipeline` boolean
    - `ExtensionSettings` ExtensionSettingsValues[]
      - `ExtensionId` string
      - `Values` unknown
    - `ForcePackageDownload` boolean
    - `Icon` IconResource
      - `Color` string — Icon background colour, as a Hex string
      - `Id` string — Font Awesome Icon Id
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `IncludedLibraryVariableSetIds` string[] — Library variable sets included in the project. Sets are listed in order of precedence, with earlier items in the list overriding any variables with the same name and scope definition appearing later in the list.
    - `IsBadgesEnabled` boolean
    - `IsDisabled` boolean
    - `IsVersionControlled` boolean
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `LifecycleId` string
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `Name` string
    - `PersistenceSettings` PersistenceSettingsResource
      - `Type` 'Database' | 'VersionControlled'
    - `ProjectConnectivityPolicy` DeploymentConnectivityPolicy
      - `AllowDeploymentsToNoTargets` boolean
      - `ExcludeUnhealthyTargets` boolean
      - `SkipMachineBehavior` 'None' | 'SkipUnavailableMachines'
      - `TargetRoles` string[]
    - `ProjectGroupId` string
    - `ProjectTags` string[] — List of tags assigned to this project
    - `ProjectTemplateDetails` ProjectTemplateDetailsResource
      - `IsShared` boolean
      - `Slug` string, required
      - `VersionMask` string, required
    - `ProvisioningRunbookId` string
    - `ReleaseCreationStrategy` ReleaseCreationStrategyResource
      - `ChannelId` string
      - `ReleaseCreationPackage` DeploymentActionPackageResource
        - `DeploymentAction` string — The name or ID of the deployment action
        - `PackageReference` string — The name or ID of the package reference
    - `ReleaseNotesTemplate` string
    - `Slug` string
    - `SpaceId` string
    - `Templates` ActionTemplateParameterResource[]
      - `DefaultValue` PropertyValueResource
        - `IsSensitive` boolean
        - `SensitiveValue` SensitiveValue
          - `HasValue` boolean
          - `Hint` string
          - `NewValue` string
        - `Value` string
      - `DisplaySettings` object
      - `HelpText` string
      - `Id` string
      - `Label` string
      - `Name` string
    - `TenantedDeploymentMode` 'Untenanted' | 'TenantedOrUntenanted' | 'Tenanted'
    - `VariableSetId` string
    - `VersioningStrategy` VersioningStrategyResource
      - `DonorPackage` DeploymentActionPackageResource
        - `DeploymentAction` string — The name or ID of the deployment action
        - `PackageReference` string — The name or ID of the package reference
      - `Template` string
  - `TenantUsages` TenantResource[]
    - `ClonedFromTenantId` string
    - `CustomFields` string[]
    - `Description` string
    - `Icon` IconResource
      - `Color` string — Icon background colour, as a Hex string
      - `Id` string — Font Awesome Icon Id
    - `Id` string — Gets or sets a unique identifier for this resource.
    - `IsDisabled` boolean
    - `LastModifiedBy` string — Gets or sets the username of the user who last modified this resource.
    - `LastModifiedOn` string, date-time — Gets or sets the date/time that this resource was last modified.
    - `Links` object — Gets or sets a dictionary of links to other related resources. These links can be used to navigate the resources on the server.
    - `Name` string
    - `ProjectEnvironments` object
    - `Slug` string
    - `SpaceId` string
    - `TenantTags` string[] — Tags are referenced by CanonicalName like {TagSetName}/{TagName}

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/revisions/b296c3a60aa5/schema)