> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Proxy Execute

> Send a raw HTTP request to a connected app's own API, authenticated with the user's connected account for that toolkit

**Slug:** `COMPOSIO_PROXY_EXECUTE`

**Tags:** openWorldHint

Sends a raw HTTP request to a connected app's own API, authenticated with your connected account, for endpoints no Composio tool covers.

## When to use it

Use `COMPOSIO_PROXY_EXECUTE` when no tool from `COMPOSIO_SEARCH_TOOLS` covers the endpoint you need. The toolkit needs an active connection first; call `COMPOSIO_MANAGE_CONNECTIONS` if it has none.

> [!NOTE]
>
> Enable it with `proxyExecute: true` in TypeScript or `proxy_execute=True` in Python. Compared with `session.proxyExecute()`, pass `toolkit_slug` instead of `toolkit`, use `type` instead of `in` for each parameter's location, and `method` also accepts `HEAD`. Composio attaches credentials. If the request cannot be sent, the tool returns `successful: false` with an `error`; an upstream non-2xx response returns normally in `data`, with its HTTP `status` and body. Large responses can be offloaded to the sandbox.

## Input parameters

**toolkit\_slug** `string` *required*

Slug of the toolkit whose connected account authenticates the request, e.g. github.

**endpoint** `string` *required*

API path relative to the app's API base URL (e.g. /user/repos), or an absolute URL on the app's own API domain.

**method** `string` *required*

HTTP method. Possible values: `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`.

**body** `any`

JSON request body, for POST, PUT and PATCH requests.

**parameters** `array\<object\>`

Extra HTTP headers or query parameters. Do not include credentials.

**properties**

**name** `string` *required*

Header or query parameter name.

**value** `string` *required*

Header or query parameter value.

**type** `string` *required*

Where to send the parameter. Possible values: `header`, `query`.

## Response

**data** `object`

**properties**

**status** `integer`

The app's HTTP status code.

**headers** `object`

The app's response headers.

**data** `any`

The app's response body.

**binary\_data** `object`

Present when the app returned a file: a download URL instead of inline content.

**error** `string`

Error if the request could not be sent.

**successful** `boolean`

Whether the request was sent and a response received.
