WorkflowAssignee

Retrieve the assignee of a specific workflow run

Audience: Programmer

Retrieves the assignee for a specific workflow run. This query fetches the assignee information from the workflow's search attributes in the Temporal workflow engine, providing visibility into who is responsible for a particular workflow execution.

Arguments

Name	Type	Description
input	GetAssigneeInput!	Input containing workflow identifiers (required)

GetAssigneeInput Fields

Field	Type	Description
workflowID	String!	The unique identifier of the workflow
workflowRunID	String!	The specific run ID of the workflow execution

Return Type

GetAssigneeResponse! - Response containing the assignee information (non-nullable)

GetAssigneeResponse Fields

Field	Type	Description
assignee	String!	The ID of the user assigned to this workflow run

Usage Example

GraphQL Query

query GetWorkflowAssignee {
  workflowAssignee(input: {
    workflowID: "order-processing-workflow-123"
    workflowRunID: "run-456-xyz"
  }) {
    assignee
  }
}

JavaScript Example

const query = `
  query GetWorkflowAssignee($input: GetAssigneeInput!) {
    workflowAssignee(input: $input) {
      assignee
    }
  }
`;

const variables = {
  input: {
    workflowID: "order-processing-workflow-123",
    workflowRunID: "run-456-xyz"
  }
};

// Using fetch API
const response = await fetch('/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${token}`
  },
  body: JSON.stringify({
    query,
    variables
  })
});

const result = await response.json();
console.log('Assignee:', result.data.workflowAssignee.assignee);

Response Example

{
  "data": {
    "workflowAssignee": {
      "assignee": "user-12345"
    }
  }
}

Error Handling

The query may return errors in the following cases:

Invalid WorkflowID

{
  "errors": [{
    "message": "invalid WorkflowID",
    "path": ["workflowAssignee"]
  }]
}

Invalid WorkflowRunID

{
  "errors": [{
    "message": "invalid WorkflowRunID",
    "path": ["workflowAssignee"]
  }]
}

Workflow Not Found

{
  "errors": [{
    "message": "workflow not found: order-processing-workflow-123",
    "path": ["workflowAssignee"]
  }]
}

Invalid Workflow Client

{
  "errors": [{
    "message": "invalid workflowClient",
    "path": ["workflowAssignee"]
  }]
}

Notes

• The assignee is stored in the workflow's search attributes under the key pyck_workflow_assignee

• If no assignee is set for the workflow, the query returns an empty string

• Requires valid authentication and appropriate tenant context

• The workflow must exist in the Temporal workflow engine for the query to succeed

• This query is useful for tracking responsibility and routing work items in workflow-driven processes

• The assignee ID typically corresponds to a user in the system's identity management (Zitadel)

Related Types

• GetAssigneeInput

• GetAssigneeResponse

Related Mutations

• setWorkflowAssignee - Set or update the assignee for a workflow run

Service

This query is provided by the workflow service as part of the federated GraphQL schema.