---
title: "POST /agent/{id}/launch"
method: POST
path: "/agent/{id}/launch"
tags: ["Agent"]
---

# POST /agent/{id}/launch

`POST /agent/{id}/launch`

Add an agent to the launch queue. The most important parameters is `output`, carefully choose yours when launching your agent with the API. For agents which take times to end, Phantombuster will send a space character every 10 seconds to prevent any timeout.

## Path parameters

- `id` integer, required

## Query parameters

- `output` 'json' | 'result-object' | 'first-result-object' | 'result-object-with-output' | 'event-stream' | 'raw'
- `argument` string
- `saveArgument` boolean

## Response `200`

Success

- object
  - `status` string
  - `message` string
  - `data` object
    - `containerId` number
    - `executionTime` number
    - `exitCode` number
    - `output` string
    - `resultObject` object — Call buster.setResultObject() to set this PlainObject.

## Other responses

- `default` — Error

---

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