---
title: "POST /agents/launch-soon"
method: POST
path: "/agents/launch-soon"
tags: ["agents"]
---

# POST /agents/launch-soon

`POST /agents/launch-soon`

Schedules an agent to launch before a specific time.

## Headers

- `X-Phantombuster-Org` string

## Request body

- object
  - `id` string, required — Id of the agent to schedule for launch.
  - `argument` union — Agent argument. Can either be a JSON string or a plain object. The argument can be retrieved with buster.argument in the agent’s script.
    - string
    - object
  - `arguments` union — Agent argument. Can either be a JSON string or a plain object. The argument can be retrieved with buster.argument in the agent’s script.
    - string
    - object
  - `minutes` integer, required — Determines in how many minutes the agent will launch. If the agent is launched manually before the expected launch time, the agent will not launch automatically.
  - `saveArgument` boolean — If true, argument will be saved as the default launch options for the agent.
  - `saveArguments` boolean — If true, argument will be saved as the default launch options for the agent.

## Response `200`

Agent has been scheduled to launch successfully.

## Other responses

- `400` — A provided parameter is duplicated or the launch argument is too big.

---

[API](https://skmtc.dev/phantombuster/apis/phantombuster-api-v2.md) · [All operations](https://skmtc.dev/phantombuster/apis/phantombuster-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/phantombuster/phantombuster-api-v2/revisions/acf0049d7c7f/schema)