Query Reference

This page documents every query on the CRE GraphQL API's root Query type that reads workflow, deployment, execution, account, or organization data.

`getAccountDetails`

Retrieves the account associated with the current API key or session.

Use this to confirm which account you're authenticated as, or to display account information in your application.

Example

query {
  getAccountDetails {
    memberId
    displayName
    emailAddress
    organizationId
  }
}

Response

{
  "data": {
    "getAccountDetails": {
      "memberId": "<MEMBER_ID>",
      "displayName": "Jane Doe",
      "emailAddress": "jane.doe@example.com",
      "organizationId": "<ORGANIZATION_ID>"
    }
  }
}

`getOrganization`

Retrieves the organization the current account belongs to.

Example

query {
  getOrganization {
    organizationId
    displayName
    restrictionStatus
    activeStatus
  }
}

Response

{
  "data": {
    "getOrganization": {
      "organizationId": "<ORGANIZATION_ID>",
      "displayName": "Acme Corp",
      "restrictionStatus": "FULL_ACCESS",
      "activeStatus": "ACTIVE"
    }
  }
}

Retrieves tenant configuration for the authenticated user: available workflow registries, deployment forwarders, and the vault gateway URL. This is the same data the CRE CLI caches locally as ~/.cre/context.yaml after login.

Requires an authenticated request (@isAuthenticated).

Arguments

None.

Returns

TenantConfig!

Non-nullable. See TenantConfig.

Example

query {
  getTenantConfig {
    tenantId
    defaultDonFamily
    vaultGatewayUrl
    registries {
      id
      label
      type
    }
  }
}

Response

{
  "data": {
    "getTenantConfig": {
      "tenantId": "<TENANT_ID>",
      "defaultDonFamily": "zone-a",
      "vaultGatewayUrl": "https://01.gateway.zone-a.cre.chain.link",
      "registries": [
        { "id": "onchain:ethereum-mainnet", "label": "ethereum-mainnet (0x1234...abcd)", "type": "ON_CHAIN" }
      ]
    }
  }
}

`workflow`

Retrieves a single workflow by its uuid.

Use this to display detailed workflow metadata, or to check a workflow's current deployment status and aggregate execution counts.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowInput!`	Yes	Identifies the workflow and the aggregation window. See `WorkflowInput`.

WorkflowInput fields:

Field	Type	Required	Description
`uuid`	`String!`	Yes	The workflow's unique identifier (CRE-generated, distinct from the onchain `workflowId`).
`from`	`Time!`	Yes	Start of the time window used to compute the workflow's aggregate fields (`executionCount`, `executionCountByStatus`, `creditUsed`).

Returns

WorkflowOutput!

Non-nullable wrapper. See WorkflowOutput and Workflow.

Example

query GetWorkflow($uuid: String!, $from: Time!) {
  workflow(input: { uuid: $uuid, from: $from }) {
    data {
      uuid
      name
      status
      executionCount
    }
  }
}

Variables

{
  "uuid": "<WORKFLOW_UUID>",
  "from": "2026-08-01T00:00:00Z"
}

Response

{
  "data": {
    "workflow": {
      "data": {
        "uuid": "<WORKFLOW_UUID>",
        "name": "price-feed-monitor",
        "status": "ACTIVE",
        "executionCount": 482
      }
    }
  }
}

`workflows`

Retrieves a paginated list of workflows for your organization, with optional filtering by owner address, status, and a text search on name.

Use this to display a workflow inventory, or to discover a workflow's uuid for use with other queries.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowsInput!`	Yes	Filters, sort order, and pagination. See `WorkflowsInput`.

WorkflowsInput fields:

Field	Type	Required	Description
`workflowOwnerAddress`	`[OnchainAddress!]`	No	Restrict results to workflows owned by one or more addresses (max 100).
`status`	`[WorkflowDeploymentStatus!]`	No	Restrict results to one or more deployment statuses (max 10). See `WorkflowDeploymentStatus`.
`search`	`String`	No	Case-insensitive text search on workflow name.
`orderBy`	`WorkflowOrderBy`	No	Sort field and direction. See `WorkflowOrderBy`.
`page`	`Page`	No	Page number and size. Defaults to page `0`, size `10`. See Pagination.

Returns

WorkflowsOutput!

Non-nullable. See WorkflowsOutput. data is the page of results; count is the total number of matching workflows across all pages.

Example

query ListWorkflows($status: [WorkflowDeploymentStatus!], $page: Page) {
  workflows(input: { status: $status, page: $page }) {
    data {
      uuid
      name
      status
    }
    count
  }
}

Variables

{
  "status": ["ACTIVE"],
  "page": { "number": 0, "size": 20 }
}

Response

{
  "data": {
    "workflows": {
      "data": [{ "uuid": "<WORKFLOW_UUID>", "name": "price-feed-monitor", "status": "ACTIVE" }],
      "count": 1
    }
  }
}

`workflowActivity`

Retrieves success/failure execution counts bucketed over a time range, for one workflow or across your organization.

Use this to build health charts or monitoring dashboards.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowActivityInput!`	Yes	See `WorkflowActivityInput`.

WorkflowActivityInput fields:

Field	Type	Required	Description
`workflowUUID`	`String`	No	Restrict to a single workflow. Omit to aggregate across your organization.
`from`	`Time`	No	Start of the time range.
`to`	`Time`	No	End of the time range.

Returns

WorkflowActivityOutput!

Non-nullable. See WorkflowActivityOutput.

Example

query WorkflowActivity($workflowUUID: String, $from: Time, $to: Time) {
  workflowActivity(input: { workflowUUID: $workflowUUID, from: $from, to: $to }) {
    data {
      from
      to
      successCount
      failureCount
    }
  }
}

Variables

{
  "workflowUUID": "<WORKFLOW_UUID>",
  "from": "2026-08-24T00:00:00Z",
  "to": "2026-08-31T00:00:00Z"
}

Response

{
  "data": {
    "workflowActivity": {
      "data": [{ "from": "2026-08-24T00:00:00Z", "to": "2026-08-25T00:00:00Z", "successCount": 68, "failureCount": 1 }]
    }
  }
}

`workflowDeployments`

Retrieves a paginated list of deployments for a workflow.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowDeploymentsInput!`	Yes	See `WorkflowDeploymentsInput`.

WorkflowDeploymentsInput fields:

Field	Type	Required	Description
`workflowUUID`	`String!`	Yes	The workflow whose deployments should be returned.
`status`	`[WorkflowDeploymentStatus!]`	No	Restrict results to one or more deployment statuses (max 10).
`from`	`Time`	No	Only include deployments created on or after this time.
`to`	`Time`	No	Only include deployments created on or before this time.
`search`	`String`	No	Text search filter.
`orderBy`	`WorkflowDeploymentOrderBy`	No	Sort field and direction. See `WorkflowDeploymentOrderBy`.
`page`	`Page`	No	Page number and size.

Returns

WorkflowDeploymentsOutput!

Non-nullable. See WorkflowDeploymentsOutput.

Example

query WorkflowDeployments($workflowUUID: String!, $page: Page) {
  workflowDeployments(input: { workflowUUID: $workflowUUID, page: $page }) {
    data {
      uuid
      status
      deployedAt
    }
    count
  }
}

Variables

{
  "workflowUUID": "<WORKFLOW_UUID>",
  "page": { "number": 0, "size": 10 }
}

Response

{
  "data": {
    "workflowDeployments": {
      "data": [{ "uuid": "<DEPLOYMENT_UUID>", "status": "ACTIVE", "deployedAt": "2026-06-01T12:00:00Z" }],
      "count": 1
    }
  }
}

`workflowDeployment`

Retrieves a single deployment by its uuid.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowDeploymentInput!`	Yes	`{ uuid: String! }` — the deployment's unique identifier.

Returns

WorkflowDeploymentOutput!

Non-nullable. See WorkflowDeploymentOutput.

Example

query WorkflowDeployment($uuid: String!) {
  workflowDeployment(input: { uuid: $uuid }) {
    data {
      uuid
      status
      binaryURL
      configURL
    }
  }
}

Variables

{
  "uuid": "<DEPLOYMENT_UUID>"
}

Response

{
  "data": {
    "workflowDeployment": {
      "data": {
        "uuid": "<DEPLOYMENT_UUID>",
        "status": "ACTIVE",
        "binaryURL": "https://.../binary.wasm",
        "configURL": "https://.../config.json"
      }
    }
  }
}

`workflowExecutions`

Retrieves a paginated list of executions, filterable by workflow, status, and time range.

Use this to build execution history views, monitor workflow health, or export execution data incrementally.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowExecutionsInput!`	Yes	See `WorkflowExecutionsInput`.

WorkflowExecutionsInput fields:

Field	Type	Required	Description
`workflowUuid`	`String`	No	Restrict to a single workflow. Omit to list executions across your organization.
`status`	`[WorkflowExecutionStatus!]`	No	Restrict results to one or more execution statuses (max 10). See `WorkflowExecutionStatus`.
`search`	`String`	No	Text search filter.
`from`	`Time`	No	Only include executions started on or after this time.
`to`	`Time`	No	Only include executions started on or before this time.
`orderBy`	`WorkflowExecutionOrderBy`	No	Sort field and direction. See `WorkflowExecutionOrderBy`.
`page`	`Page`	No	Page number and size.

Returns

WorkflowExecutionsOutput!

Non-nullable. See WorkflowExecutionsOutput.

Example

query WorkflowExecutions($workflowUuid: String, $status: [WorkflowExecutionStatus!], $page: Page) {
  workflowExecutions(input: { workflowUuid: $workflowUuid, status: $status, page: $page }) {
    data {
      uuid
      status
      startedAt
      finishedAt
    }
    count
  }
}

Variables

{
  "workflowUuid": "<WORKFLOW_UUID>",
  "status": ["FAILURE"],
  "page": { "number": 0, "size": 10 }
}

Response

{
  "data": {
    "workflowExecutions": {
      "data": [
        {
          "uuid": "<EXECUTION_UUID>",
          "status": "FAILURE",
          "startedAt": "2026-08-31T09:12:00Z",
          "finishedAt": "2026-08-31T09:12:05Z"
        }
      ],
      "count": 1
    }
  }
}

`workflowExecution`

Retrieves a single execution by its uuid.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowExecutionInput!`	Yes	`{ uuid: String! }` — the execution's unique identifier.

Returns

WorkflowExecutionOutput!

Non-nullable wrapper. data: WorkflowExecution is nullable — it's null if no execution matches the given uuid. See WorkflowExecutionOutput.

Example

query GetExecution($uuid: String!) {
  workflowExecution(input: { uuid: $uuid }) {
    data {
      uuid
      status
      startedAt
      finishedAt
      errors {
        error
        count
      }
    }
  }
}

Variables

{
  "uuid": "<EXECUTION_UUID>"
}

Response

{
  "data": {
    "workflowExecution": {
      "data": {
        "uuid": "<EXECUTION_UUID>",
        "status": "SUCCESS",
        "startedAt": "2026-08-31T11:45:00Z",
        "finishedAt": "2026-08-31T11:45:02Z",
        "errors": null
      }
    }
  }
}

`workflowExecutionLogs`

Retrieves the log lines emitted during an execution.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowExecutionLogsInput!`	Yes	`{ workflowExecutionUUID: String! }` — the execution whose logs should be returned.

Returns

WorkflowExecutionLogsOutput!

Non-nullable wrapper; data is a nullable list. See WorkflowExecutionLogsOutput.

Example

query ExecutionLogs($workflowExecutionUUID: String!) {
  workflowExecutionLogs(input: { workflowExecutionUUID: $workflowExecutionUUID }) {
    data {
      nodeID
      message
      timestamp
    }
  }
}

Variables

{
  "workflowExecutionUUID": "<EXECUTION_UUID>"
}

Response

{
  "data": {
    "workflowExecutionLogs": {
      "data": [{ "nodeID": "<NODE_ID>", "message": "execution completed", "timestamp": "2026-08-31T11:45:02Z" }]
    }
  }
}

`workflowExecutionEvents`

Retrieves the per-capability event timeline for an execution, optionally filtered by capability ID or status.

Arguments

Argument	Type	Required	Description
`input`	`WorkflowExecutionEventsInput!`	Yes	See `WorkflowExecutionEventsInput`.

WorkflowExecutionEventsInput fields:

Field	Type	Required	Description
`workflowExecutionUUID`	`String!`	Yes	The execution whose events should be returned.
`capabilityID`	`String`	No	Restrict results to a single capability.
`status`	`String`	No	Restrict results to a single event status string.

Returns

WorkflowExecutionEventsOutput!

Non-nullable wrapper; data is a nullable list. See WorkflowExecutionEventsOutput.

Example

query ExecutionEvents($workflowExecutionUUID: String!) {
  workflowExecutionEvents(input: { workflowExecutionUUID: $workflowExecutionUUID }) {
    data {
      capabilityID
      status
      startedAt
      finishedAt
    }
  }
}

Variables

{
  "workflowExecutionUUID": "<EXECUTION_UUID>"
}

Response

{
  "data": {
    "workflowExecutionEvents": {
      "data": [
        {
          "capabilityID": "http-trigger@1.0.0",
          "status": "COMPLETED",
          "startedAt": "2026-08-31T11:45:00Z",
          "finishedAt": "2026-08-31T11:45:01Z"
        }
      ]
    }
  }
}

Query Reference

Get the latest Chainlink content straight to your inbox.