---
id: workflow-signal-send
title: Send a signal to an execution
description: >-
  Delivers a signal to an execution waiting on it. The request body is passed
  through verbatim as the signal payload. Returns 409 when the execution is not
  waiting on that signal.
sidebar_label: Send a signal to an execution
hide_title: true
hide_table_of_contents: true
api: >-
  eJztV01v2zgQ/SsEL22xiu226barW9ptgfTQBkmKFAiMeCyOJLYSyZKUHUPQf18MKdtK7CS72csuEF+sj+HwzeOb0UzLPRSOp5f8QtufeaWXzMlCQeX4NOECXWal8VIrnvI/sZILtI5Bb8O8ZqAYXmPWkA1bgvRSFUwrJv2InZfILP5q0Hk212LFpGMGnEPBfGl1U5RsgXYOXtYMHPMlrh0bWFUaxIidom+scuxw8gdblqiC0XZD6ZjSfrivL8H3XkY84dqgBTI9Fjzlyz7Gg2iQOlSCJ9yAhRo9WiKi5ZKCNeBLnnAFNfKUSzKjUKRFwVNvG0y4y0qsgact9ytDVs5bqQre3Sbu/CZmQcDwGmpT0Sp6c/Uufw0v56+yQ/EGeZfsBRH+/iWMnl9ytUvllsabCMEYqxdQpRad0coh76YRBzr/XosVbZ5p5VF5ugRjKpkF2sc/HO3d7qLU8x+YeX4b5JGdS2/Brtjns69fEiai6FDcoZAh0LZHuuUm03UdQPGq8DXv6Jdwh1ljpV+F054jWLRHjS95ejmNgcUoHXl8NZnQ351MLsFtMRKaR/NgLInVy7jvxufAdK51haAoZNXUPL2kIKcUUMByLHZFMDxGJ4urILLX4hDf5L9P3r58FynpEn74/ftunB8qicoztFbbmM4hjR2sHFtSoi3p9dJqVaShEpAhmxGEWcKAlU0N6sAiCJhXyGYCPciKXimRULYuoJIiEMRykFVj0dFzZKi8XTGDluk8RyVIlrnE6j6KjdXzCuvf9lAtfWDgJFrw5AERhvP1oARY0QcVAn9++ukDe/tu8pb1e7EYkUuYQ7uIIp3dhWn2YrRzzBHH7qndxPMxQCAb9u30OGE4KkZsVnpvXDoeb6vaynmsRwIX4wDabV8p7Q9y3Sgxu5naj/JBpaWn9D69fdGebeydB98MQuZSeSzQDlccTg5D0SJKH3LN1rDYUvqSScGW+ZXML97PL3LTFBP6LEnnHe0tFR1m9gDcTaBuLDCXShL5bnzLLfmLxAy8gbWw2jm1E4uO8mO/ztOHdS491u7hUhG+EveH5jwaN3YZqHGmVS7D16FG56B4gJW6cZ6VsIhfcvrusH73FXuWaYHP+hISqsibfVXkm8Jrg5lHEbPE9gXlKZOfMvkpk/+TmRx8+lJT02y0C0gDtiG3m97RjVspunE/OIxb6i47Tn0WZXtsqhtbDUQKRo5UU1WmAp9rW48yXYemct2anVHGR1KGDdomPnLE+943tEbBiCf9xSdta6C27/PFOadoKGtPtw3rx7/fMpLock2WFEvUw8vRZDThm9ThXwahsKOTY1pFtNUQylffv5+hEnfOTrc1N2io/5eDV39OHq/92FQgQ7oFEaxlfrkZx1zQ6VpMPOFpmLfWg2jC08DgNOElaTG95G07B4ffbNV19PhXg5a6+WnCF2AlNZtBdEI6uhY8zaFyeA/Fz0/7nHjB9k1re6NZlwxFBWMBVUN3POE/cRVHRprjHg3hH0xqj0AXCO1odigRBNpAV3z1ISI6OCcH26U7wwxFF1ccZRkaf6/tdFBQTr6enVOm9oNjrQWtsbCk4RaWEaY2UQxpG5+1vAJVNKHK8eiT8hpuloVbZSBEtZeIto0W5/onqq7b8OLpnojpur8Ak775NQ==
sidebar_class_name: post api-method
info_path: docs/api/nullplatform-api
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/workflow-signal-send'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Send a signal to an execution"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/workflows/executions/{id}/signals/{name}"}
  context={"endpoint"}
>

</MethodEndpoint>

Delivers a signal to an execution waiting on it. The request body is passed through verbatim as the signal payload. Returns 409 when the execution is not waiting on that signal.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string"},"description":"The execution id.","example":"exec_8f3a1b2c4d5e"},{"in":"path","name":"name","required":true,"schema":{"type":"string"},"description":"The signal name the execution is waiting on.","example":"approval:response"}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"content":{"application/json":{"schema":{"type":"object","description":"Arbitrary JSON, delivered as the signal payload.","example":{"approved":true,"comment":"lgtm"}}}}}}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The signal was delivered.","content":{"application/json":{"schema":{"type":"object","properties":{"delivered":{"type":"boolean","enum":[true]},"signalId":{"type":"string","example":"sig_a1b2c3d4e5f60718"}}}}}},"4XX":{"description":"Client error. The body says what went wrong: an error `type`, a human-readable `detail`, and, on validation failures, one entry per offending field.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}},"5XX":{"description":"Unexpected server error.","content":{"application/problem+json":{"schema":{"title":"Problem","type":"object","description":"The standard error body (RFC 7807 problem details, served as `application/problem+json`).","properties":{"type":{"type":"string","description":"Error type URI, e.g. `https://workflow-system.dev/errors/workflow-not-found`.","example":"https://workflow-system.dev/errors/workflow-not-found"},"title":{"type":"string","example":"Not found"},"status":{"type":"integer","example":404},"detail":{"type":"string","example":"No workflow with id wf_ifWBbWfpug0n exists"},"instance":{"type":"string","example":"/workflows/definitions/wf_ifWBbWfpug0n"},"errors":{"type":"array","description":"Present on validation failures: one entry per offending field.","items":{"type":"object","properties":{"path":{"type":"string","example":"/steps/scan/config"},"message":{"type":"string","example":"must have required property 'code'"}}}}}}}}}}}
>

</StatusCodes>