---
canonical_url: "https://docs.composio.dev/toolkits/meta-tools/proxy_execute"
markdown_url: "https://docs.composio.dev/toolkits/meta-tools/proxy_execute.md"
product: "platform"
version: null
last_updated: null
---

# Proxy Execute

**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.

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. — 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.
  - Array items:
    - `name` (string) *(required)*: Header or query parameter name.
    - `value` (string) *(required)*: Header or query parameter value.
    - `type` (string) *(required)*: Where to send the parameter. — values: `header`, `query`

## Response

- `data` (object) *(required)*
  - `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) *(required)*: Whether the request was sent and a response received.


---

📚 **More documentation:** [View all docs](https://docs.composio.dev/llms.txt) | [Glossary](https://docs.composio.dev/llms.mdx/reference/glossary) | [Examples](https://docs.composio.dev/llms.mdx/examples) | [API Reference](https://docs.composio.dev/llms.mdx/reference)