---
title: "Gets usages for an Action Template."
method: GET
path: "/{spaceId}/actiontemplates/{id}/usage"
tags: ["ActionTemplates"]
---

# Gets usages for an Action Template.

`GET /{spaceId}/actiontemplates/{id}/usage`

Gets a list of all steps/deployment processes that use a given action template.

## Path parameters

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

## Query parameters

- `branch` string
- `process` 'Deployment' | 'Runbook'
- `project` string
- `withUpdates` boolean

## Response `200`

The requested Action Template usages

- ActionTemplateUsageResource[]
  - `ActionId` string, required
  - `ActionName` string, required
  - `ActionTemplateId` string, required
  - `Branch` string
  - `DeploymentProcessId` string
  - `Id` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `Links` object
  - `ProcessId` string, required
  - `ProcessType` 'Deployment' | 'Runbook'
  - `ProjectId` string, required
  - `ProjectName` string, required
  - `ProjectSlug` string, required
  - `Release` string
  - `RunbookId` string
  - `RunbookName` string
  - `StepId` string, required
  - `StepName` string, required
  - `Version` string

## 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/versions/bc9158facfc7/schema)