Skip to content
Ona API Reference
Ona Docs
API Reference
Automations

ListWorkflowExecutionActions

automations.list_execution_actions(AutomationListExecutionActionsParams**kwargs) -> SyncWorkflowExecutionActionsPage[WorkflowExecutionAction]
POST/gitpod.v1.WorkflowService/ListWorkflowExecutionActions

Lists workflow execution actions with optional filtering.

Use this method to:

  • Monitor individual action execution status
  • Debug action failures
  • Track resource usage per action

Examples

  • List execution actions for workflow execution:

    Shows all execution actions for a specific workflow execution.

    filter:
  workflowExecutionIds: ["d2c94c27-3b76-4a42-b88c-95a85e392c68"]
pagination:
  pageSize: 20
ParametersExpand Collapse
token: Optional[str]
page_size: Optional[int]
maximum100
minimum0
filter: Optional[Filter]
phases: Optional[List[Literal["WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED", "WORKFLOW_EXECUTION_ACTION_PHASE_PENDING", "WORKFLOW_EXECUTION_ACTION_PHASE_RUNNING", 5 more]]]
One of the following:
"WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED"
"WORKFLOW_EXECUTION_ACTION_PHASE_PENDING"
"WORKFLOW_EXECUTION_ACTION_PHASE_RUNNING"
"WORKFLOW_EXECUTION_ACTION_PHASE_STOPPING"
"WORKFLOW_EXECUTION_ACTION_PHASE_STOPPED"
"WORKFLOW_EXECUTION_ACTION_PHASE_DELETING"
"WORKFLOW_EXECUTION_ACTION_PHASE_DELETED"
"WORKFLOW_EXECUTION_ACTION_PHASE_DONE"
workflow_execution_action_ids: Optional[Sequence[str]]
workflow_execution_ids: Optional[Sequence[str]]
workflow_ids: Optional[Sequence[str]]
ReturnsExpand Collapse
class WorkflowExecutionAction: …

WorkflowExecutionAction represents a workflow execution action instance.

id: Optional[str]
formatuuid
metadata: Optional[Metadata]

WorkflowExecutionActionMetadata contains workflow execution action metadata.

action_name: Optional[str]

Human-readable name for this action based on its context. Examples: “gitpod-io/gitpod-next” for repository context, “My Project” for project context. Will be empty string for actions created before this field was added.

finished_at: Optional[datetime]

A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one.

All minutes are 60 seconds long. Leap seconds are “smeared” so that no leap second table is needed for interpretation, using a 24-hour linear smear.

The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

Examples

Example 1: Compute Timestamp from POSIX time().

 Timestamp timestamp;
 timestamp.set_seconds(time(NULL));
 timestamp.set_nanos(0);

Example 2: Compute Timestamp from POSIX gettimeofday().

 struct timeval tv;
 gettimeofday(&tv, NULL);

 Timestamp timestamp;
 timestamp.set_seconds(tv.tv_sec);
 timestamp.set_nanos(tv.tv_usec * 1000);

Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime().

 FILETIME ft;
 GetSystemTimeAsFileTime(&ft);
 UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;

 // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
 // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
 Timestamp timestamp;
 timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
 timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));

Example 4: Compute Timestamp from Java System.currentTimeMillis().

 long millis = System.currentTimeMillis();

 Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     .setNanos((int) ((millis % 1000) * 1000000)).build();

Example 5: Compute Timestamp from Java Instant.now().

 Instant now = Instant.now();

 Timestamp timestamp =
     Timestamp.newBuilder().setSeconds(now.getEpochSecond())
         .setNanos(now.getNano()).build();

Example 6: Compute Timestamp from current time in Python.

 timestamp = Timestamp()
 timestamp.GetCurrentTime()

JSON Mapping

In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is “{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z” where {year} is always expressed using four digits while {month}, {day}, {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The “Z” suffix indicates the timezone (“UTC”); the timezone is required. A proto3 JSON serializer should always use UTC (as indicated by “Z”) when printing the Timestamp type and a proto3 JSON parser should be able to accept both UTC and other timezones (as indicated by an offset).

For example, “2017-01-15T01:30:15.01Z” encodes 15.01 seconds past 01:30 UTC on January 15, 2017.

In JavaScript, one can convert a Date object to this format using the standard toISOString() method. In Python, a standard datetime.datetime object can be converted to this format using strftime with the time format spec ‘%Y-%m-%dT%H:%M:%S.%fZ’. Likewise, in Java, one can use the Joda Time’s ISODateTimeFormat.dateTime() to obtain a formatter capable of generating timestamps in this format.

formatdate-time
started_at: Optional[datetime]

A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one.

All minutes are 60 seconds long. Leap seconds are “smeared” so that no leap second table is needed for interpretation, using a 24-hour linear smear.

The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

Examples

Example 1: Compute Timestamp from POSIX time().

 Timestamp timestamp;
 timestamp.set_seconds(time(NULL));
 timestamp.set_nanos(0);

Example 2: Compute Timestamp from POSIX gettimeofday().

 struct timeval tv;
 gettimeofday(&tv, NULL);

 Timestamp timestamp;
 timestamp.set_seconds(tv.tv_sec);
 timestamp.set_nanos(tv.tv_usec * 1000);

Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime().

 FILETIME ft;
 GetSystemTimeAsFileTime(&ft);
 UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;

 // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
 // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
 Timestamp timestamp;
 timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
 timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));

Example 4: Compute Timestamp from Java System.currentTimeMillis().

 long millis = System.currentTimeMillis();

 Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     .setNanos((int) ((millis % 1000) * 1000000)).build();

Example 5: Compute Timestamp from Java Instant.now().

 Instant now = Instant.now();

 Timestamp timestamp =
     Timestamp.newBuilder().setSeconds(now.getEpochSecond())
         .setNanos(now.getNano()).build();

Example 6: Compute Timestamp from current time in Python.

 timestamp = Timestamp()
 timestamp.GetCurrentTime()

JSON Mapping

In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is “{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z” where {year} is always expressed using four digits while {month}, {day}, {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The “Z” suffix indicates the timezone (“UTC”); the timezone is required. A proto3 JSON serializer should always use UTC (as indicated by “Z”) when printing the Timestamp type and a proto3 JSON parser should be able to accept both UTC and other timezones (as indicated by an offset).

For example, “2017-01-15T01:30:15.01Z” encodes 15.01 seconds past 01:30 UTC on January 15, 2017.

In JavaScript, one can convert a Date object to this format using the standard toISOString() method. In Python, a standard datetime.datetime object can be converted to this format using strftime with the time format spec ‘%Y-%m-%dT%H:%M:%S.%fZ’. Likewise, in Java, one can use the Joda Time’s ISODateTimeFormat.dateTime() to obtain a formatter capable of generating timestamps in this format.

formatdate-time
workflow_execution_id: Optional[str]
formatuuid
workflow_id: Optional[str]
formatuuid
spec: Optional[Spec]

WorkflowExecutionActionSpec contains the specification for this execution action.

context: Optional[AgentCodeContext]

Context for the execution action - specifies where and how the action executes. This is resolved from the workflow trigger context and contains the specific project, repository, or agent context for this execution instance.

context_url: Optional[ContextURL]
environment_class_id: Optional[str]
formatuuid
url: Optional[str]
formaturi
environment_id: Optional[str]
formatuuid
project_id: Optional[str]
formatuuid
pull_request: Optional[PullRequest]

Pull request context - optional metadata about the PR being worked on This is populated when the agent execution is triggered by a PR workflow or when explicitly provided through the browser extension

id: Optional[str]

Unique identifier from the source system (e.g., “123” for GitHub PR #123)

author: Optional[str]

Author name as provided by the SCM system

draft: Optional[bool]

Whether this is a draft pull request

from_branch: Optional[str]

Source branch name (the branch being merged from)

repository: Optional[PullRequestRepository]

Repository information

clone_url: Optional[str]
host: Optional[str]
name: Optional[str]
owner: Optional[str]
state: Optional[State]

Current state of the pull request

One of the following:
"STATE_UNSPECIFIED"
"STATE_OPEN"
"STATE_CLOSED"
"STATE_MERGED"
title: Optional[str]

Pull request title

to_branch: Optional[str]

Target branch name (the branch being merged into)

url: Optional[str]

Pull request URL (e.g., “https://github.com/owner/repo/pull/123”)

limits: Optional[SpecLimits]

PerExecution defines limits per execution action.

max_time: Optional[str]

Maximum time allowed for a single execution action. Use standard duration format (e.g., “30m” for 30 minutes, “2h” for 2 hours).

formatregex
status: Optional[Status]

WorkflowExecutionActionStatus contains the current status of a workflow execution action.

agent_execution_id: Optional[str]
environment_id: Optional[str]
formatuuid
failures: Optional[List[StatusFailure]]

Structured failures that caused the workflow execution action to fail. Provides detailed error codes, messages, and retry information.

code: Optional[Literal["WORKFLOW_ERROR_CODE_UNSPECIFIED", "WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR", "WORKFLOW_ERROR_CODE_AGENT_ERROR"]]

Error code identifying the type of error.

One of the following:
"WORKFLOW_ERROR_CODE_UNSPECIFIED"
"WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR"
"WORKFLOW_ERROR_CODE_AGENT_ERROR"
message: Optional[str]

Human-readable error message.

meta: Optional[Dict[str, str]]

Additional metadata about the error. Common keys include:

  • environment_id: ID of the environment
  • task_id: ID of the task
  • service_id: ID of the service
  • workflow_id: ID of the workflow
  • workflow_execution_id: ID of the workflow execution
reason: Optional[str]

Reason explaining why the error occurred. Examples: “not_found”, “stopped”, “deleted”, “creation_failed”, “start_failed”

retry: Optional[StatusFailureRetry]

Retry configuration. If not set, the error is considered non-retriable.

retriable: Optional[bool]

Whether the error is retriable.

retry_after: Optional[str]

Suggested duration to wait before retrying. Only meaningful when retriable is true.

formatregex
phase: Optional[Literal["WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED", "WORKFLOW_EXECUTION_ACTION_PHASE_PENDING", "WORKFLOW_EXECUTION_ACTION_PHASE_RUNNING", 5 more]]

WorkflowExecutionActionPhase defines the phases of workflow execution action.

One of the following:
"WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED"
"WORKFLOW_EXECUTION_ACTION_PHASE_PENDING"
"WORKFLOW_EXECUTION_ACTION_PHASE_RUNNING"
"WORKFLOW_EXECUTION_ACTION_PHASE_STOPPING"
"WORKFLOW_EXECUTION_ACTION_PHASE_STOPPED"
"WORKFLOW_EXECUTION_ACTION_PHASE_DELETING"
"WORKFLOW_EXECUTION_ACTION_PHASE_DELETED"
"WORKFLOW_EXECUTION_ACTION_PHASE_DONE"
step_statuses: Optional[List[StatusStepStatus]]

Step-level progress tracking

error: Optional[StatusStepStatusError]

Structured error that caused the step to fail. Provides detailed error code, message, and retry information.

code: Optional[Literal["WORKFLOW_ERROR_CODE_UNSPECIFIED", "WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR", "WORKFLOW_ERROR_CODE_AGENT_ERROR"]]

Error code identifying the type of error.

One of the following:
"WORKFLOW_ERROR_CODE_UNSPECIFIED"
"WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR"
"WORKFLOW_ERROR_CODE_AGENT_ERROR"
message: Optional[str]

Human-readable error message.

meta: Optional[Dict[str, str]]

Additional metadata about the error. Common keys include:

  • environment_id: ID of the environment
  • task_id: ID of the task
  • service_id: ID of the service
  • workflow_id: ID of the workflow
  • workflow_execution_id: ID of the workflow execution
reason: Optional[str]

Reason explaining why the error occurred. Examples: “not_found”, “stopped”, “deleted”, “creation_failed”, “start_failed”

retry: Optional[StatusStepStatusErrorRetry]

Retry configuration. If not set, the error is considered non-retriable.

retriable: Optional[bool]

Whether the error is retriable.

retry_after: Optional[str]

Suggested duration to wait before retrying. Only meaningful when retriable is true.

formatregex
finished_at: Optional[datetime]

A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one.

All minutes are 60 seconds long. Leap seconds are “smeared” so that no leap second table is needed for interpretation, using a 24-hour linear smear.

The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

Examples

Example 1: Compute Timestamp from POSIX time().

 Timestamp timestamp;
 timestamp.set_seconds(time(NULL));
 timestamp.set_nanos(0);

Example 2: Compute Timestamp from POSIX gettimeofday().

 struct timeval tv;
 gettimeofday(&tv, NULL);

 Timestamp timestamp;
 timestamp.set_seconds(tv.tv_sec);
 timestamp.set_nanos(tv.tv_usec * 1000);

Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime().

 FILETIME ft;
 GetSystemTimeAsFileTime(&ft);
 UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;

 // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
 // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
 Timestamp timestamp;
 timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
 timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));

Example 4: Compute Timestamp from Java System.currentTimeMillis().

 long millis = System.currentTimeMillis();

 Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     .setNanos((int) ((millis % 1000) * 1000000)).build();

Example 5: Compute Timestamp from Java Instant.now().

 Instant now = Instant.now();

 Timestamp timestamp =
     Timestamp.newBuilder().setSeconds(now.getEpochSecond())
         .setNanos(now.getNano()).build();

Example 6: Compute Timestamp from current time in Python.

 timestamp = Timestamp()
 timestamp.GetCurrentTime()

JSON Mapping

In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is “{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z” where {year} is always expressed using four digits while {month}, {day}, {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The “Z” suffix indicates the timezone (“UTC”); the timezone is required. A proto3 JSON serializer should always use UTC (as indicated by “Z”) when printing the Timestamp type and a proto3 JSON parser should be able to accept both UTC and other timezones (as indicated by an offset).

For example, “2017-01-15T01:30:15.01Z” encodes 15.01 seconds past 01:30 UTC on January 15, 2017.

In JavaScript, one can convert a Date object to this format using the standard toISOString() method. In Python, a standard datetime.datetime object can be converted to this format using strftime with the time format spec ‘%Y-%m-%dT%H:%M:%S.%fZ’. Likewise, in Java, one can use the Joda Time’s ISODateTimeFormat.dateTime() to obtain a formatter capable of generating timestamps in this format.

formatdate-time
phase: Optional[Literal["STEP_PHASE_UNSPECIFIED", "STEP_PHASE_PENDING", "STEP_PHASE_RUNNING", 3 more]]
One of the following:
"STEP_PHASE_UNSPECIFIED"
"STEP_PHASE_PENDING"
"STEP_PHASE_RUNNING"
"STEP_PHASE_DONE"
"STEP_PHASE_FAILED"
"STEP_PHASE_CANCELLED"
started_at: Optional[datetime]

A Timestamp represents a point in time independent of any time zone or local calendar, encoded as a count of seconds and fractions of seconds at nanosecond resolution. The count is relative to an epoch at UTC midnight on January 1, 1970, in the proleptic Gregorian calendar which extends the Gregorian calendar backwards to year one.

All minutes are 60 seconds long. Leap seconds are “smeared” so that no leap second table is needed for interpretation, using a 24-hour linear smear.

The range is from 0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z. By restricting to that range, we ensure that we can convert to and from RFC 3339 date strings.

Examples

Example 1: Compute Timestamp from POSIX time().

 Timestamp timestamp;
 timestamp.set_seconds(time(NULL));
 timestamp.set_nanos(0);

Example 2: Compute Timestamp from POSIX gettimeofday().

 struct timeval tv;
 gettimeofday(&tv, NULL);

 Timestamp timestamp;
 timestamp.set_seconds(tv.tv_sec);
 timestamp.set_nanos(tv.tv_usec * 1000);

Example 3: Compute Timestamp from Win32 GetSystemTimeAsFileTime().

 FILETIME ft;
 GetSystemTimeAsFileTime(&ft);
 UINT64 ticks = (((UINT64)ft.dwHighDateTime) << 32) | ft.dwLowDateTime;

 // A Windows tick is 100 nanoseconds. Windows epoch 1601-01-01T00:00:00Z
 // is 11644473600 seconds before Unix epoch 1970-01-01T00:00:00Z.
 Timestamp timestamp;
 timestamp.set_seconds((INT64) ((ticks / 10000000) - 11644473600LL));
 timestamp.set_nanos((INT32) ((ticks % 10000000) * 100));

Example 4: Compute Timestamp from Java System.currentTimeMillis().

 long millis = System.currentTimeMillis();

 Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     .setNanos((int) ((millis % 1000) * 1000000)).build();

Example 5: Compute Timestamp from Java Instant.now().

 Instant now = Instant.now();

 Timestamp timestamp =
     Timestamp.newBuilder().setSeconds(now.getEpochSecond())
         .setNanos(now.getNano()).build();

Example 6: Compute Timestamp from current time in Python.

 timestamp = Timestamp()
 timestamp.GetCurrentTime()

JSON Mapping

In JSON format, the Timestamp type is encoded as a string in the RFC 3339 format. That is, the format is “{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z” where {year} is always expressed using four digits while {month}, {day}, {hour}, {min}, and {sec} are zero-padded to two digits each. The fractional seconds, which can go up to 9 digits (i.e. up to 1 nanosecond resolution), are optional. The “Z” suffix indicates the timezone (“UTC”); the timezone is required. A proto3 JSON serializer should always use UTC (as indicated by “Z”) when printing the Timestamp type and a proto3 JSON parser should be able to accept both UTC and other timezones (as indicated by an offset).

For example, “2017-01-15T01:30:15.01Z” encodes 15.01 seconds past 01:30 UTC on January 15, 2017.

In JavaScript, one can convert a Date object to this format using the standard toISOString() method. In Python, a standard datetime.datetime object can be converted to this format using strftime with the time format spec ‘%Y-%m-%dT%H:%M:%S.%fZ’. Likewise, in Java, one can use the Joda Time’s ISODateTimeFormat.dateTime() to obtain a formatter capable of generating timestamps in this format.

formatdate-time
step: Optional[WorkflowStep]

The step definition captured at execution time for immutability. This ensures the UI shows the correct step even if the workflow definition changes.

agent: Optional[Agent]

WorkflowAgentStep represents an agent step that executes with a prompt.

prompt: Optional[str]

Prompt must be between 1 and 20,000 characters:

size(this) >= 1 && size(this) <= 20000
pull_request: Optional[PullRequest]

WorkflowPullRequestStep represents a pull request creation step.

branch: Optional[str]

Branch name must be between 1 and 255 characters:

size(this) >= 1 && size(this) <= 255
description: Optional[str]

Description must be at most 20,000 characters:

size(this) <= 20000
draft: Optional[bool]
title: Optional[str]

Title must be between 1 and 500 characters:

size(this) >= 1 && size(this) <= 500
task: Optional[Task]

WorkflowTaskStep represents a task step that executes a command.

command: Optional[str]

Command must be between 1 and 20,000 characters:

size(this) >= 1 && size(this) <= 20000
step_index: Optional[int]

Index of the step in the workflow action steps array

formatint32
warnings: Optional[List[StatusWarning]]

Structured warnings about the workflow execution action. Provides detailed warning codes and messages.

code: Optional[Literal["WORKFLOW_ERROR_CODE_UNSPECIFIED", "WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR", "WORKFLOW_ERROR_CODE_AGENT_ERROR"]]

Error code identifying the type of error.

One of the following:
"WORKFLOW_ERROR_CODE_UNSPECIFIED"
"WORKFLOW_ERROR_CODE_ENVIRONMENT_ERROR"
"WORKFLOW_ERROR_CODE_AGENT_ERROR"
message: Optional[str]

Human-readable error message.

meta: Optional[Dict[str, str]]

Additional metadata about the error. Common keys include:

  • environment_id: ID of the environment
  • task_id: ID of the task
  • service_id: ID of the service
  • workflow_id: ID of the workflow
  • workflow_execution_id: ID of the workflow execution
reason: Optional[str]

Reason explaining why the error occurred. Examples: “not_found”, “stopped”, “deleted”, “creation_failed”, “start_failed”

retry: Optional[StatusWarningRetry]

Retry configuration. If not set, the error is considered non-retriable.

retriable: Optional[bool]

Whether the error is retriable.

retry_after: Optional[str]

Suggested duration to wait before retrying. Only meaningful when retriable is true.

formatregex

ListWorkflowExecutionActions

import os
from gitpod import Gitpod

client = Gitpod(
    bearer_token=os.environ.get("GITPOD_API_KEY"),  # This is the default and can be omitted
)
page = client.automations.list_execution_actions(
    filter={
        "workflow_execution_ids": ["d2c94c27-3b76-4a42-b88c-95a85e392c68"]
    },
    pagination={
        "page_size": 20
    },
)
page = page.workflow_execution_actions[0]
print(page.id)
{
  "pagination": {
    "nextToken": "nextToken"
  },
  "workflowExecutionActions": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "metadata": {
        "actionName": "actionName",
        "finishedAt": "2019-12-27T18:11:19.117Z",
        "startedAt": "2019-12-27T18:11:19.117Z",
        "workflowExecutionId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "workflowId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
      },
      "spec": {
        "context": {
          "contextUrl": {
            "environmentClassId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "url": "https://example.com"
          },
          "environmentId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "projectId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "pullRequest": {
            "id": "id",
            "author": "author",
            "draft": true,
            "fromBranch": "fromBranch",
            "repository": {
              "cloneUrl": "cloneUrl",
              "host": "host",
              "name": "name",
              "owner": "owner"
            },
            "state": "STATE_UNSPECIFIED",
            "title": "title",
            "toBranch": "toBranch",
            "url": "url"
          }
        },
        "desiredPhase": "WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED",
        "limits": {
          "maxTime": "+9125115.360s"
        },
        "session": "session"
      },
      "status": {
        "agentExecutionId": "agentExecutionId",
        "environmentId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "failureMessage": "failureMessage",
        "failures": [
          {
            "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
            "message": "message",
            "meta": {
              "foo": "string"
            },
            "reason": "reason",
            "retry": {
              "retriable": true,
              "retryAfter": "+9125115.360s"
            }
          }
        ],
        "phase": "WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED",
        "session": "session",
        "stepStatuses": [
          {
            "error": {
              "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
              "message": "message",
              "meta": {
                "foo": "string"
              },
              "reason": "reason",
              "retry": {
                "retriable": true,
                "retryAfter": "+9125115.360s"
              }
            },
            "failureMessage": "failureMessage",
            "finishedAt": "2019-12-27T18:11:19.117Z",
            "phase": "STEP_PHASE_UNSPECIFIED",
            "startedAt": "2019-12-27T18:11:19.117Z",
            "step": {
              "agent": {
                "prompt": "prompt"
              },
              "pullRequest": {
                "branch": "branch",
                "description": "description",
                "draft": true,
                "title": "title"
              },
              "report": {
                "outputs": [
                  {
                    "acceptanceCriteria": "acceptanceCriteria",
                    "boolean": {},
                    "command": "command",
                    "float": {
                      "max": 0,
                      "min": 0
                    },
                    "integer": {
                      "max": 0,
                      "min": 0
                    },
                    "key": "key",
                    "prompt": "prompt",
                    "string": {
                      "pattern": "pattern"
                    },
                    "title": "title"
                  }
                ]
              },
              "task": {
                "command": "command"
              }
            },
            "stepIndex": 0
          }
        ],
        "warningMessage": "warningMessage",
        "warnings": [
          {
            "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
            "message": "message",
            "meta": {
              "foo": "string"
            },
            "reason": "reason",
            "retry": {
              "retriable": true,
              "retryAfter": "+9125115.360s"
            }
          }
        ]
      }
    }
  ]
}
Returns Examples
{
  "pagination": {
    "nextToken": "nextToken"
  },
  "workflowExecutionActions": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "metadata": {
        "actionName": "actionName",
        "finishedAt": "2019-12-27T18:11:19.117Z",
        "startedAt": "2019-12-27T18:11:19.117Z",
        "workflowExecutionId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "workflowId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
      },
      "spec": {
        "context": {
          "contextUrl": {
            "environmentClassId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            "url": "https://example.com"
          },
          "environmentId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "projectId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
          "pullRequest": {
            "id": "id",
            "author": "author",
            "draft": true,
            "fromBranch": "fromBranch",
            "repository": {
              "cloneUrl": "cloneUrl",
              "host": "host",
              "name": "name",
              "owner": "owner"
            },
            "state": "STATE_UNSPECIFIED",
            "title": "title",
            "toBranch": "toBranch",
            "url": "url"
          }
        },
        "desiredPhase": "WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED",
        "limits": {
          "maxTime": "+9125115.360s"
        },
        "session": "session"
      },
      "status": {
        "agentExecutionId": "agentExecutionId",
        "environmentId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "failureMessage": "failureMessage",
        "failures": [
          {
            "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
            "message": "message",
            "meta": {
              "foo": "string"
            },
            "reason": "reason",
            "retry": {
              "retriable": true,
              "retryAfter": "+9125115.360s"
            }
          }
        ],
        "phase": "WORKFLOW_EXECUTION_ACTION_PHASE_UNSPECIFIED",
        "session": "session",
        "stepStatuses": [
          {
            "error": {
              "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
              "message": "message",
              "meta": {
                "foo": "string"
              },
              "reason": "reason",
              "retry": {
                "retriable": true,
                "retryAfter": "+9125115.360s"
              }
            },
            "failureMessage": "failureMessage",
            "finishedAt": "2019-12-27T18:11:19.117Z",
            "phase": "STEP_PHASE_UNSPECIFIED",
            "startedAt": "2019-12-27T18:11:19.117Z",
            "step": {
              "agent": {
                "prompt": "prompt"
              },
              "pullRequest": {
                "branch": "branch",
                "description": "description",
                "draft": true,
                "title": "title"
              },
              "report": {
                "outputs": [
                  {
                    "acceptanceCriteria": "acceptanceCriteria",
                    "boolean": {},
                    "command": "command",
                    "float": {
                      "max": 0,
                      "min": 0
                    },
                    "integer": {
                      "max": 0,
                      "min": 0
                    },
                    "key": "key",
                    "prompt": "prompt",
                    "string": {
                      "pattern": "pattern"
                    },
                    "title": "title"
                  }
                ]
              },
              "task": {
                "command": "command"
              }
            },
            "stepIndex": 0
          }
        ],
        "warningMessage": "warningMessage",
        "warnings": [
          {
            "code": "WORKFLOW_ERROR_CODE_UNSPECIFIED",
            "message": "message",
            "meta": {
              "foo": "string"
            },
            "reason": "reason",
            "retry": {
              "retriable": true,
              "retryAfter": "+9125115.360s"
            }
          }
        ]
      }
    }
  ]
}