# Stop Machine (/machines/Machines_stop)

Stop a specific Machine within an app, with an optional request body to specify signal and timeout.


`POST /apps/{app_name}/machines/{machine_id}/stop`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `app_name` | path | `string` | Yes | Fly App Name |
| `machine_id` | path | `string` | Yes | Machine ID |

## Request Body

Type: `StopRequest`

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `signal` | `string` | No | Enum: SIGHUP, SIGINT, SIGQUIT, SIGKILL, SIGUSR1, SIGUSR2, SIGTERM |
| `timeout` | `string` | No |  |

## Responses

| Status | Description | Schema |
| --- | --- | --- |
| `200` | OK |  |
| `400` | Bad Request | `ErrorResponse` |

The full machine-readable OpenAPI spec is available at /openapi.json.