Send a query to an workflow

Always targets the latest run; runId cannot be pinned for Temporal query operations.

POST /workflow/{id}/query/{query}

Send a query to an workflow

cURL

curl --request POST \
  --url http://localhost:3001/workflow/{id}/query/{query} \
  --header 'Content-Type: application/json' \
  --data '{
  "payload": {}
}'

400

{
  "error": "ValidationError",
  "message": "Invalid Payload",
  "issues": [
    {}
  ]
}

Path Parameters

id · string · required

The workflow id

query · string · required

The query name

Body

application/json

Body must contain payload; payload is sent to Temporal

payload · object

The payload sent to the query operation

Response

200

Success