---
title: "Deprecated: use POST /plugins/app:{app}/call. Call a third-party API through a granted connection [write]"
method: POST
path: "/connectors/proxy"
tags: ["connectors"]
deprecated: true
---

# Deprecated: use POST /plugins/app:{app}/call. Call a third-party API through a granted connection \[write\]

`POST /connectors/proxy`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/connectors/proxy`
- Auth: HTTP bearer

> **Deprecated.**

Deprecated: use `POST /plugins/app:{app}/call`. Still served exactly as before; every answer carries a `Deprecation` header. For services holding an API key: the same gateway sessions use through `actl connector call`. The connection must be granted to this key (or its workspace) by its owner; otherwise 404 `not_granted`. `url` must be https (400 `https_required`); `method` defaults to GET; `headers` and `body` are passed to the third party. The answer carries the third party's `status`, `ok` and `body` as text. The workspace's tool-call rules decide first: a block rule, or a require_approval rule (a service call has no thread to be approved in), answers 403 `capability_denied`; rules that cannot be read answer 503 `policy_unavailable`. Native GitHub uses https://api.github.com directly, with no per-call connector charge or funded-wallet requirement. GitHub credentials and redirects cannot be overridden; legacy managed GitHub handles require native reconnection (409 github_reconnect_required). Other managed connectors book one CONNECTOR_CALL on a 2xx; other statuses are not billed. Every call is recorded for the connection's owner (host, method, status). 403 `key_required` for a browser session or a task pass; 502 `proxy_error` when the third party could not be reached.

## Request body

- object
  - `connection_id` string, required
  - `url` string, required: The third-party API address, https.
  - `method` string
  - `headers` object
  - `body` string

## Response `200`

The third party's answer

- object
  - `status` integer, required
  - `ok` boolean, required
  - `body` string, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/connectors/proxy/post.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)