Skip to main content
Version: 0.6.0

Queries

All root-level query fields available in the TFGQL schema.

QueryReturn TypeDescription
adminUsers(filter: UserFilter, search: String, admin: Boolean, suspended: Boolean)[AdminUser!]!Lists all Terraform Enterprise users available to site administrators.
agentPools(includeOrgs: [String!], excludeOrgs: [String!], filter: AgentPoolFilter)[AgentPool!]!
agentPool(id: ID!)AgentPool
agentTokens(poolId: ID!, filter: AgentTokenFilter)[AgentToken!]!
agentToken(id: ID!)AgentToken
agents(poolId: ID!, filter: AgentFilter)[Agent!]!
agent(id: ID!)Agent
applyForRun(runId: ID!)Apply
apply(id: ID!)Apply
appliesForWorkspace(workspaceId: ID!, filter: ApplyFilter)[Apply!]!
appliesForProject(projectId: ID!, filter: ApplyFilter)[Apply!]!
appliesForOrganization(organizationId: ID!, filter: ApplyFilter)[Apply!]!
assessmentResults(workspaceId: ID!, filter: AssessmentResultFilter)[AssessmentResult!]!
assessmentResult(id: ID!)AssessmentResult
comments(runId: ID!, filter: CommentFilter)[Comment!]!
comment(id: ID!)Comment
configurationVersion(id: ID!)ConfigurationVersion
configurationVersions(workspaceId: ID!, filter: ConfigurationVersionFilter)[ConfigurationVersion]!
workspacesWithConfigurationVersionsLargerThan(includeOrgs: [String!], excludeOrgs: [String!], bytes: Int!)[Workspace]!
explorerWorkspaces(includeOrgs: [String!], excludeOrgs: [String!], sort: [ExplorerWorkspaceSortInput!], filters: [ExplorerWorkspaceFilterInput!])[ExplorerWorkspaceRow!]!
explorerTerraformVersions(includeOrgs: [String!], excludeOrgs: [String!], sort: [ExplorerTerraformVersionSortInput!], filters: [ExplorerTerraformVersionFilterInput!])[ExplorerTerraformVersionRow!]!
explorerProviders(includeOrgs: [String!], excludeOrgs: [String!], sort: [ExplorerProviderSortInput!], filters: [ExplorerProviderFilterInput!])[ExplorerProviderRow!]!
explorerModules(includeOrgs: [String!], excludeOrgs: [String!], sort: [ExplorerModuleSortInput!], filters: [ExplorerModuleFilterInput!])[ExplorerModuleRow!]!
organizationMemberships(includeOrgs: [String!], excludeOrgs: [String!], filter: OrganizationMembershipFilter)[OrganizationMembership!]!
organizationMembership(id: ID!)OrganizationMembership
myOrganizationMemberships(filter: OrganizationMembershipFilter)[OrganizationMembership!]!
organizationTags(includeOrgs: [String!], excludeOrgs: [String!], filter: OrganizationTagFilter)[OrganizationTag!]!
organizations(filter: OrganizationFilter)[Organization!]!
organization(name: String!)Organization
plan(id: ID!)Plan
policies(includeOrgs: [String!], excludeOrgs: [String!], filter: PolicyFilter)[Policy!]!
policy(id: ID!)Policy
policyEvaluations(taskStageId: ID!, filter: PolicyEvaluationFilter)[PolicyEvaluation!]!
policySetParameters(policySetId: ID!, filter: PolicySetParameterFilter)[PolicySetParameter!]!
policySets(includeOrgs: [String!], excludeOrgs: [String!], filter: PolicySetFilter)[PolicySet!]!
policySet(id: ID!)PolicySet
projectTeamAccessByProject(projectId: ID!, filter: ProjectTeamAccessFilter)[ProjectTeamAccess!]!
projectTeamAccessByTeam(teamId: ID!, filter: ProjectTeamAccessFilter)[ProjectTeamAccess!]!
projectTeamAccessById(id: ID!)ProjectTeamAccess
projects(includeOrgs: [String!], excludeOrgs: [String!], filter: ProjectFilter)[Project!]!
project(id: ID!)Project
metrics(format: MetricFormat, names: [String!], includeOrgs: [String!], excludeOrgs: [String!])PrometheusResult!Execute all configured metric definitions and return results in Prometheus exposition format.
metricFromQuery(name: String!, help: String, type: String, query: String!, variables: JSON, resultPath: String!, valueField: String!, labels: JSON!, format: MetricFormat)PrometheusResult!Execute a single ad-hoc metric query. The caller supplies the GraphQL query, result path, value field, and label mappings.
runTriggers(workspaceId: ID!, filter: RunTriggerFilter)[WorkspaceRunTrigger!]!
runTrigger(id: ID!)RunTrigger
runsForWorkspace(workspaceId: ID!, filter: RunFilter)[Run!]!
run(id: ID!)Run
runs(includeOrgs: [String!], excludeOrgs: [String!], filter: RunFilter)[Run!]!
runsWithOverriddenPolicy(includeOrgs: [String!], excludeOrgs: [String!], filter: RunFilter)[Run!]!
runsWithPlanApplyFilter(includeOrgs: [String!], excludeOrgs: [String!], filter: RunFilter, planFilter: PlanFilter, applyFilter: ApplyFilter)[Run!]!
stateVersionOutputs(stateVersionId: ID!, filter: StateVersionOutputFilter)[StateVersionOutput!]!
stateVersionOutput(id: ID!)StateVersionOutput
searchStateVersionOutputs(includeOrgs: [String!], excludeOrgs: [String!], filter: StateVersionOutputFilter!)[StateVersionOutput!]!
stateVersions(orgName: String!, workspaceName: String!, filter: StateVersionFilter)[StateVersion!]!
stateVersion(id: ID!)StateVersion
workspaceCurrentStateVersion(workspaceId: ID!)StateVersion
teamTokens(teamId: ID!, filter: TeamTokenFilter)[TeamToken!]!
teamToken(id: ID!)TeamToken
teams(includeOrgs: [String!], excludeOrgs: [String!], filter: TeamFilter)[Team!]!
teamsByQuery(organization: String!, query: String!, filter: TeamFilter)[Team!]!
teamsByName(organization: String!, names: [String!]!, filter: TeamFilter)[Team!]!
team(id: ID!)Team
user(id: ID!)User
meUser
variableSets(includeOrgs: [String!], excludeOrgs: [String!], filter: VariableSetFilter)[VariableSet!]!
variableSet(id: ID!)VariableSet
variables(organization: String!, workspaceName: String!, filter: VariableFilter)[Variable!]!
workspacesWithTFLogCategory(includeOrgs: [String!], excludeOrgs: [String!], categories: [TF_LOG_CATEGORY!]!)[Workspace!]!
workspaceResources(workspaceId: ID!, filter: WorkspaceResourceFilter)[WorkspaceResource!]!
workspaceTeamAccessByWorkspace(workspaceId: ID!, filter: WorkspaceTeamAccessFilter)[WorkspaceTeamAccess!]!
workspaceTeamAccessByTeam(teamId: ID!, filter: WorkspaceTeamAccessFilter)[WorkspaceTeamAccess!]!
workspaceTeamAccessById(id: ID!)WorkspaceTeamAccess
workspaces(includeOrgs: [String!], excludeOrgs: [String!], filter: WorkspaceFilter)[Workspace!]!
workspace(id: ID!)Workspace
workspaceByName(organization: String!, workspaceName: String!)Workspace
workspacesWithNoResources(includeOrgs: [String!], excludeOrgs: [String!], filter: WorkspaceFilter)[Workspace!]!
workspacesWithFailedPolicyChecks(includeOrgs: [String!], excludeOrgs: [String!], filter: WorkspaceFilter)[Workspace!]!
workspacesWithOpenCurrentRun(includeOrgs: [String!], excludeOrgs: [String!], filter: WorkspaceFilter)[Workspace!]!List all workspaces across the selected organizations that have at least one run matching the given runFilter (e.g. non-terminal states).
runTriggerGraph(includeOrgs: [String!], excludeOrgs: [String!])[WorkspaceRunTrigger!]!List all run-trigger edges (workspace dependency graph) across the selected organizations.