---
title: "Describe action"
method: GET
path: "/actions/{actionId}"
tags: ["actions"]
---

# Describe action

`GET /actions/{actionId}`

Retrieves the details of the action identified by the given `actionId`.

## Path parameters

- `actionId` string, required

## Query parameters

- `workspaceId` integer
- `attributes` ActionQueryAttribute[]

## Response `200`

OK

- DescribeActionResponse
  - `action` ActionResponseDto
    - `config` union
      - object
        - `discriminator` string
      - object
        - `discriminator` string
        - `events` string[]
      - object
        - `discriminator` string
        - `bucketName` string
        - `dataLinkId` string
        - `datasetId` string
        - `events` string[]
        - `filter` string
        - `markerFile` string
        - `subscriptionArn` string
        - `topicArn` string
      - object
        - `discriminator` string
        - `expression` string
        - `preset` string
        - `timezone` string
    - `dateCreated` string, date-time
    - `error` string
    - `event` union
      - object
        - `discriminator` string
        - `timestamp` string, date-time
        - `commitId` string
        - `commitMessage` string
        - `pusherEmail` string
        - `pusherName` string
        - `ref` string
      - object
        - `discriminator` string
        - `timestamp` string, date-time
        - `workflowId` string
      - object
        - `discriminator` string
        - `timestamp` string, date-time
        - `bucketName` string
        - `eventName` string
        - `provider` string
        - `recordCount` integer
      - object
        - `discriminator` string
        - `timestamp` string, date-time
        - `scheduledTime` string, date-time
        - `workflowId` string
    - `hookId` string
    - `hookUrl` string
    - `id` string
    - `labels` LabelDbDto[]
      - `dateCreated` string, date-time
      - `id` integer
      - `isDefault` boolean
      - `isDynamic` boolean
      - `isInterpolated` boolean
      - `name` string
      - `resource` boolean
      - `value` string
    - `lastSeen` string, date-time
    - `lastUpdated` string, date-time
    - `launch` LaunchDbDto
      - `commitId` string
      - `computeEnv` ComputeEnvComputeConfig
        - `config` union, required
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `cliPath` string
            - `computeJobRole` string
            - `computeQueue` string
            - `deletedResources` object[]
              - …
            - `dragenInstanceType` string
            - `dragenQueue` string
            - `executionRole` string
            - `forge` ForgeConfig
              - …
            - `forgedResources` object[]
              - …
            - `fusion2Enabled` boolean
            - `fusionSnapshots` boolean
            - `headJobCpus` integer
            - `headJobMemoryMb` integer
            - `headJobRole` string
            - `headQueue` string
            - `logGroup` string
            - `lustreId` string
            - `nvnmeStorageEnabled` boolean
            - `region` string
            - `storageType` string
            - `volumes` string[]
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `allowBuckets` string[]
            - `arm64Enabled` boolean
            - `deletedResources` object[]
              - …
            - `ebsBootSize` integer
            - `ebsEncrypted` boolean — When true, the boot EBS volume of provisioned instances is encrypted. Null/absent (the default) is treated as false — no encryption.
            - `ebsKmsKeyId` string — Optional KMS key ARN used to encrypt the boot EBS volume. Only applied when ebsEncrypted is true. When omitted, the account/region default EBS encryption key is used.
            - `ec2KeyPair` string
            - `forgedResources` object[]
              - …
            - `fusion2Enabled` boolean
            - `gpuEnabled` boolean
            - `imageId` string
            - `instanceProfileArn` string
            - `instanceType` string
            - `logGroup` string
            - `region` string
            - `schedConfig` SchedConfig
              - …
            - `schedEnabled` boolean
            - `securityGroups` string[]
            - `subnetId` string — DEPRECATED — use subnetIds. Kept in sync with the first element of subnetIds.
            - `subnetIds` string[] — Subnets to launch into. Basic uses the first; Intelligent Compute may use all.
            - `vpcId` string — The VPC used to scope subnet and security-group selection.
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `defaultDataRetentionPolicy` boolean
            - `instanceTypeSize` 'SMALL' | 'MEDIUM' | 'LARGE'
            - `region` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `bootDiskImage` string
            - `bootDiskSizeGb` integer
            - `computeJobsInstanceTemplate` string
            - `computeJobsMachineType` string[]
            - `copyImage` string
            - `cpuPlatform` string
            - `debugMode` integer
            - `fusion2Enabled` boolean
            - `fusionSnapshots` boolean
            - `headJobCpus` integer
            - `headJobInstanceTemplate` string
            - `headJobMemoryMb` integer
            - `labels` object
            - `location` string
            - `machineType` string
            - `network` string
            - `networkTags` string[]
            - `nfsMount` string
            - `nfsTarget` string
            - `projectId` string
            - `serviceAccount` string
            - `spot` boolean
            - `sshDaemon` boolean
            - `sshImage` string
            - `subnetwork` string
            - `usePrivateAddress` boolean
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `arm64Enabled` boolean
            - `bootDiskSizeGb` integer
            - `deletedResources` object[]
              - …
            - `forgedResources` object[]
              - …
            - `fusion2Enabled` boolean
            - `gpuEnabled` boolean
            - `imageId` string
            - `instanceType` string
            - `projectId` string
            - `region` string
            - `schedConfig` SchedConfig
              - …
            - `schedEnabled` boolean
            - `serviceAccountEmail` string
            - `waveEnabled` boolean
            - `zone` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `autoPoolMode` boolean
            - `deleteJobsOnCompletion` 'on_success' | 'always' | 'never'
            - `deleteJobsOnCompletionEnabled` boolean, nullable
            - `deletePoolsOnCompletion` boolean
            - `deleteTasksOnCompletion` boolean, nullable
            - `forge` AzBatchForgeConfig
              - …
            - `fusion2Enabled` boolean
            - `headJobCpus` integer, nullable — Number of CPU slots reserved on the head pool VM for the Nextflow head job. Defaults to 1 so multiple head jobs can share a head pool VM; increase to dedicate more CPU and memory to each head job.
            - `headJobMemoryMb` integer, nullable — Memory in MiB reserved for the Nextflow head job container. When omitted, the value is derived from the head pool VM size as the per-slot share (vmMemory / vmCpus) multiplied by the requested slot count.
            - `headPool` string
            - `jobMaxWallClockTime` string, nullable — Maximum wall clock time for Azure Batch jobs before automatic termination. Accepts human-readable duration syntax (e.g., '7d', '1d1h1m'). Defaults to 7d when not specified. Maximum: 180 days.
            - `managedIdentityClientId` string, nullable
            - `managedIdentityHeadResourceId` string, nullable
            - `managedIdentityPoolClientId` string, nullable
            - `managedIdentityPoolResourceId` string, nullable
            - `region` string
            - `subnetId` string, nullable — Azure VNet subnet resource ID for private network isolation. Requires Entra (service principal) credentials.
            - `terminateJobsOnCompletion` boolean, nullable
            - `tokenDuration` string
            - `waveEnabled` boolean
            - `workerPool` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `dataCollectionEndpoint` string
            - `dataCollectionRuleId` string
            - `deletedResources` MapEntryStringString[]
              - …
            - `forgedResources` MapEntryStringString[]
              - …
            - `fusion2Enabled` boolean
            - `instanceType` string
            - `logTableName` string
            - `logWorkspaceId` string
            - `managedIdentityClientId` string
            - `managedIdentityId` string
            - `networkId` string
            - `region` string
            - `resourceGroup` string
            - `schedConfig` SchedConfig
              - …
            - `schedEnabled` boolean
            - `subnets` string[]
            - `subscriptionId` string
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeQueue` string
            - `headJobOptions` string
            - `headQueue` string
            - `hostName` string
            - `launchDir` string
            - `maxQueueSize` integer
            - `perJobMemLimit` boolean
            - `perTaskReserve` boolean
            - `port` integer
            - `propagateHeadJobOptions` boolean
            - `unitForLimits` string
            - `userName` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeQueue` string
            - `headJobOptions` string
            - `headQueue` string
            - `hostName` string
            - `launchDir` string
            - `maxQueueSize` integer
            - `port` integer
            - `propagateHeadJobOptions` boolean
            - `userName` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeServiceAccount` string
            - `headJobCpus` integer
            - `headJobMemoryMb` integer
            - `headPodSpec` string
            - `headServiceAccount` string
            - `namespace` string
            - `podCleanup` 'on_success' | 'always' | 'never'
            - `server` string
            - `servicePodSpec` string
            - `sslCert` string
            - `storageClaimName` string
            - `storageMountPath` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `clusterName` string — The AWS EKS cluster name
            - `computeServiceAccount` string
            - `fusion2Enabled` boolean
            - `headJobCpus` integer
            - `headJobMemoryMb` integer
            - `headPodSpec` string
            - `headServiceAccount` string
            - `namespace` string
            - `podCleanup` 'on_success' | 'always' | 'never'
            - `region` string — AWS region
            - `server` string
            - `servicePodSpec` string
            - `sslCert` string
            - `storageClaimName` string
            - `storageMountPath` string
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `clusterName` string — The GKE cluster name
            - `computeServiceAccount` string
            - `fusion2Enabled` boolean
            - `headJobCpus` integer
            - `headJobMemoryMb` integer
            - `headPodSpec` string
            - `headServiceAccount` string
            - `namespace` string
            - `podCleanup` 'on_success' | 'always' | 'never'
            - `region` string — The GKE cluster region - or - zone
            - `server` string
            - `servicePodSpec` string
            - `sslCert` string
            - `storageClaimName` string
            - `storageMountPath` string
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeQueue` string
            - `headJobOptions` string
            - `headQueue` string
            - `hostName` string
            - `launchDir` string
            - `maxQueueSize` integer
            - `port` integer
            - `propagateHeadJobOptions` boolean
            - `userName` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeQueue` string
            - `headJobOptions` string
            - `headQueue` string
            - `hostName` string
            - `launchDir` string
            - `maxQueueSize` integer
            - `port` integer
            - `propagateHeadJobOptions` boolean
            - `userName` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `computeQueue` string
            - `headJobOptions` string
            - `headQueue` string
            - `hostName` string
            - `launchDir` string
            - `maxQueueSize` integer
            - `port` integer
            - `propagateHeadJobOptions` boolean
            - `userName` string
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `fusion2Enabled` boolean
            - `schedConfig` SchedConfig
              - …
            - `schedEnabled` boolean
            - `waveEnabled` boolean
          - object
            - `discriminator` string — property to select the compute config platform
            - `environment` ConfigEnvVariable[]
              - …
            - `nextflowConfig` string
            - `postRunScript` string — Add a script that executes after all Nextflow processes have completed. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `preRunScript` string — Add a script that executes in the nf-launch script prior to invoking Nextflow processes. See [Pre and post-run scripts](https://docs.seqera.io/platform-cloud/launch/advanced#pre-and-post-run-scripts).
            - `workDir` string — Compute environment working directory
            - `bootDiskSizeGb` integer
            - `copyImage` string
            - `debugMode` integer
            - `headJobCpus` integer
            - `headJobMemoryMb` integer
            - `labels` object
            - `location` string
            - `nfsMount` string
            - `nfsTarget` string
            - `preemptible` boolean
            - `projectId` string
            - `region` string
            - `sshDaemon` boolean
            - `sshImage` string
            - `usePrivateAddress` boolean
            - `zones` string[]
        - `credentialsId` string
        - `dateCreated` string, date-time
        - `deleted` boolean
        - `description` string
        - `fusionMetricsCollectionEnabled` boolean
        - `id` string
        - `lastUpdated` string, date-time
        - `lastUsed` string, date-time
        - `message` string
        - `name` string, required
        - `orgId` integer
        - `platform` 'aws-batch' | 'aws-cloud' | 'seqeracompute-platform' | 'google-batch' | 'google-cloud' | 'azure-batch' | 'azure-cloud' | 'k8s-platform' | 'eks-platform' | 'gke-platform' | 'uge-platform' | 'slurm-platform' | 'lsf-platform' | 'altair-platform' | 'moab-platform' | 'local-platform' | 'google-lifesciences', required
        - `primary` boolean
        - `status` 'CREATING' | 'AVAILABLE' | 'DISABLED' | 'DELETING' | 'ERRORED' | 'INVALID' | 'DELETED'
        - `workspaceId` integer
      - `configProfiles` string[]
      - `configText` string
      - `dateCreated` string, date-time
      - `entryName` string
      - `headJobCpus` integer
      - `headJobMemoryMb` integer
      - `id` string
      - `lastUpdated` string, date-time
      - `launchContainer` string
      - `mainScript` string
      - `nextflowVersion` string, nullable — Nextflow release version to run this workflow with; must exist in the system catalog and satisfy the minimum configured for the compute environment's type.
      - `optimizationId` string
      - `optimizationTargets` string
      - `outputDir` string, nullable — Per-run output directory passed as Nextflow -output-dir (requires Nextflow 24.10.0 or later and workflow outputs syntax).
      - `paramsText` string
      - `pipeline` string
      - `pipelineSchemaId` integer
      - `postRunScript` string
      - `preRunScript` string
      - `pullLatest` boolean
      - `resume` boolean
      - `resumeLaunchId` string
      - `revision` string
      - `runName` string
      - `schemaName` string
      - `sessionId` string
      - `stubRun` boolean
      - `syntaxParser` 'v1' | 'v2', nullable
      - `towerConfig` string
      - `userSecrets` string[]
      - `workDir` string
      - `workspaceId` integer
      - `workspaceSecrets` string[]
    - `name` string
    - `nextExecution` string, date-time
    - `source` 'github' | 'tower' | 'bucket' | 'cron'
    - `status` 'CREATING' | 'ACTIVE' | 'ERROR' | 'PAUSED'

## Other responses

- `400` — Bad request
- `403` — Operation not allowed

---

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