Actions

Reference documentation for GraphQL schema types in the Actions category.

In this article

Objects

Workflow

Object

A workflow contains meta information about an Actions workflow file.

Workflow Implements

Fields for Workflow

NameDescription

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

id (ID!)

The Node ID of the Workflow object.

name (String!)

The name of the workflow.

resourcePath (URI!)

The HTTP path for this workflow.

runs (WorkflowRunConnection!)

The runs of the workflow.

Arguments for runs

  • after (String)

    Returns the elements in the list that come after the specified cursor.

  • before (String)

    Returns the elements in the list that come before the specified cursor.

  • first (Int)

    Returns the first n elements from the list.

  • last (Int)

    Returns the last n elements from the list.

state (WorkflowState!)

The state of the workflow.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The HTTP URL for this workflow.

WorkflowFileReference

Object

A workflow that must run for this rule to pass.

Fields for WorkflowFileReference

NameDescription

path (String!)

The path to the workflow file.

ref (String)

The ref (branch or tag) of the workflow file to use.

repositoryId (Int!)

The ID of the repository where the workflow is defined.

sha (String)

The commit SHA of the workflow file to use.

WorkflowRun

Object

A workflow run.

WorkflowRun Implements

Fields for WorkflowRun

NameDescription

checkSuite (CheckSuite!)

The check suite this workflow run belongs to.

createdAt (DateTime!)

Identifies the date and time when the object was created.

databaseId (Int)

Identifies the primary key from the database.

deploymentReviews (DeploymentReviewConnection!)

The log of deployment reviews.

Arguments for deploymentReviews

  • after (String)

    Returns the elements in the list that come after the specified cursor.

  • before (String)

    Returns the elements in the list that come before the specified cursor.

  • first (Int)

    Returns the first n elements from the list.

  • last (Int)

    Returns the last n elements from the list.

displayTitle (String)

The human-readable title of the workflow run.

event (String!)

The event that triggered the workflow run.

file (WorkflowRunFile)

The workflow file.

id (ID!)

The Node ID of the WorkflowRun object.

pendingDeploymentRequests (DeploymentRequestConnection!)

The pending deployment requests of all check runs in this workflow run.

Arguments for pendingDeploymentRequests

  • after (String)

    Returns the elements in the list that come after the specified cursor.

  • before (String)

    Returns the elements in the list that come before the specified cursor.

  • first (Int)

    Returns the first n elements from the list.

  • last (Int)

    Returns the last n elements from the list.

resourcePath (URI!)

The HTTP path for this workflow run.

runAttempt (Int!)

The attempt number of this workflow run.

runNumber (Int!)

A number that uniquely identifies this workflow run in its parent workflow.

updatedAt (DateTime!)

Identifies the date and time when the object was last updated.

url (URI!)

The HTTP URL for this workflow run.

workflow (Workflow!)

The workflow executed in this workflow run.

WorkflowRunConnection

Object

The connection type for WorkflowRun.

Fields for WorkflowRunConnection

NameDescription

edges ([WorkflowRunEdge])

A list of edges.

nodes ([WorkflowRun])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

WorkflowRunEdge

Object

An edge in a connection.

Fields for WorkflowRunEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (WorkflowRun)

The item at the end of the edge.

WorkflowRunFile

Object

An executed workflow file for a workflow run.

WorkflowRunFile Implements

Fields for WorkflowRunFile

NameDescription

id (ID!)

The Node ID of the WorkflowRunFile object.

path (String!)

The path of the workflow file relative to its repository.

repositoryFileUrl (URI!)

The direct link to the file in the repository which stores the workflow file.

repositoryName (URI!)

The repository name and owner which stores the workflow file.

resourcePath (URI!)

The HTTP path for this workflow run file.

run (WorkflowRun!)

The parent workflow run execution for this file.

url (URI!)

The HTTP URL for this workflow run file.

viewerCanPushRepository (Boolean!)

If the viewer has permissions to push to the repository which stores the workflow.

viewerCanReadRepository (Boolean!)

If the viewer has permissions to read the repository which stores the workflow.

WorkflowsParameters

Object

Require all changes made to a targeted branch to pass the specified workflows before they can be merged.

Fields for WorkflowsParameters

NameDescription

doNotEnforceOnCreate (Boolean!)

Allow repositories and branches to be created if a check would otherwise prohibit it.

workflows ([WorkflowFileReference!]!)

Workflows that must pass for this rule to pass.

Enums

WorkflowRunOrderField