---
title: "Run a platform connector endpoint"
method: POST
path: "/v1/data/{artifactId}/platform/{provider}/{endpoint}/execute"
tags: ["Data"]
---

# Run a platform connector endpoint

`POST /v1/data/{artifactId}/platform/{provider}/{endpoint}/execute`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/data/{artifactId}/platform/{provider}/{endpoint}/execute`
- Auth: HTTP bearer

Runs a workspace platform connector server-side; credentials never reach the caller. Allowed for the artifact owner and workspace members. Under a row-level access policy, a scoped viewer can only run a query declared in `access_policy.queries`, by `query` name; their `params` are ignored and the server binds their scope into the declared SQL (otherwise `403 SCOPE_REQUIRED`). Connection ids: `GET /v1/workspaces/{workspaceId}/connections` (any member), or `GET /v1/data/{artifactId}/platform/connections` (artifact owner).

## Request body

- object
  - `connectionId` string: Required unless `query` names a declared query (which fixes the connection).
  - `query` string: Name of a query in the artifact's `access_policy.queries`.
  - `params` object
    - `body` object
    - `queryParams` object
    - `pathParams` object

## Response `200`

`{ success, data, meta }` — `data` is the provider result.

## Other responses

- `403`: Access denied

## Changes

- **2026-10-17** `08f935e1d035`: 2 info
  - added the new optional request property `query`
  - the request property `connectionId` became optional
- **2026-10-15** `e80fee24553e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/data/:artifactId/platform/:provider/:endpoint/execute/post.md)

---

[API](https://skmtc.dev/shareout/apis/shareout-rest-api.md) - [All operations](https://skmtc.dev/shareout/apis/shareout-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shareout/apis/shareout-rest-api/revisions/1e3f7fd34f6d?raw)