> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperlane.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Reprocess Message

Re-queue a message for processing on demand. This endpoint allows external services to trigger message delivery instead of relying on queue backoff, and can handle scenarios like blockchain network reorganizations or manual message processing.

<Note>
  For purely on-demand processing without automatic retries, combine this endpoint with `max_message_retries := 0` in your relayer configuration. This ensures messages are only processed when explicitly triggered via this API.
</Note>

<Expandable title="Request Body">
  <ParamField body="origin_id" type="u32" required>
    Domain/chain ID where the message originated
  </ParamField>

  <ParamField body="message_id" type="string" required>
    Hex-encoded message identifier (H256)
  </ParamField>
</Expandable>

<Expandable title="Response Body">
  <ResponseField name="success" type="boolean">
    Whether the message was successfully re-queued for processing
  </ResponseField>

  <ResponseField name="message" type="string">
    Details about the reprocessing operation
  </ResponseField>
</Expandable>

<RequestExample>
  ```bash curl theme={null}
  curl -X POST "http://localhost:9090/reprocess_message" \
    -H "Content-Type: application/json" \
    -d \
  '{
    "origin_id": 1399811149,
    "message_id": "0x9484bd5c635b17b28cb382249d7a6fe5ca15debfd4f824247c68d47badc5b7de"
  }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('http://localhost:9090/reprocess_message', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      origin_id: 1399811149,
      message_id: "0x9484bd5c635b17b28cb382249d7a6fe5ca15debfd4f824247c68d47badc5b7de"
    })
  });
  ```

  ```python Python theme={null}
  import requests

  response = requests.post('http://localhost:9090/reprocess_message', json={
    'origin_id': 1399811149,
    'message_id': '0x9484bd5c635b17b28cb382249d7a6fe5ca15debfd4f824247c68d47badc5b7de'
  })
  ```
</RequestExample>

<ResponseExample>
  ```json Success Response theme={null}
  {
    "success": true,
    "message": "Message re-queued for processing"
  }
  ```

  ```json Error Response (400 Bad Request) theme={null}
  {
    "error": "Invalid message_id format"
  }
  ```

  ```json Error Response (404 Not Found) theme={null}
  {
    "error": "Message or context not found"
  }
  ```
</ResponseExample>