> This page is for version 2025-09-18 (default). > For other versions, use one of these documentation indexes: > - 2025-09-18 (default): https://apidocs.polytomic.com/2025-09-18/llms.txt > - 2024-02-08: https://apidocs.polytomic.com/2024-02-08/llms.txt > - 2023-04-25: https://apidocs.polytomic.com/2023-04-25/llms.txt > - 2022-12-12: https://apidocs.polytomic.com/2022-12-12/llms.txt > - 2021-05-23: https://apidocs.polytomic.com/2021-05-23/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://apidocs.polytomic.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://apidocs.polytomic.com/_mcp/server. # Set Harbor Action Configuration PUT https://app.polytomic.com/api/harbors/{harbor_id}/action-configuration/connections/{connection_id} Content-Type: application/json Creates or replaces action grants for an eligible Harbor source Connection. You must be an Organization administrator with permission to edit both the Harbor and the source Connection. Use a normal writable API credential, not a Harbor profile credential. Your Organization must have the Harbor Actions entitlement. The Connection must populate the Harbor through a non-deleted Bulk Sync or Model Sync targeting its backing Connection. This requirement applies to new grants and replacements, even when you only remove fields from an existing grant. Submit the complete grant set for this Connection. Omit `expected_revision` to create it, or supply the current revision to replace it. A missing, stale, or unexpected revision returns `409 Conflict`; read configuration again before retrying. Successful replacement creates a new revision. For mutating operations, `field_ids` selects input fields and `lookup_field_ids` must be omitted. For read-only operations, `field_ids` selects output fields and `lookup_field_ids` selects allowed lookup fields. Duplicate operations or field IDs are invalid. An empty grant set is invalid; remove the Connection's grants instead. This request changes permissions only. It does not execute provider actions. Reference: https://apidocs.polytomic.com/api-reference/harbors/set-action-configuration ## Authentication - `Authorization` header (bearer token, required) — Bearer user API key - `Authorization` header (basic auth, required) — Basic organization-scoped API key ## Request ### Path parameters - `harbor_id` (string, required) — Unique identifier of the Harbor. - `connection_id` (string, required) — Source Connection whose action grants you want to manage. ### Body (application/json) This endpoint expects a SetHarborActionConfigurationRequest. - `grants` (list of HarborActionGrantSchema, required, nullable) — Complete replacement of this Connection's action grants. - `expected_revision` (string, optional) — Current revision when replacing existing grants. Omit when creating grants for this Connection. ## Response ### 200 OK - `data` (list of HarborActionConfigurationResponse, optional, nullable) — All configured action Connections after this request. ## Errors ### 403 Forbidden Error Forbidden - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 404 Not Found Error Not Found - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 409 Conflict Error Conflict - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 422 Unprocessable Entity Error Unprocessable Entity - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 500 Internal Server Error Internal Server Error - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ### 503 Service Unavailable Error Service Unavailable - `key` (string, optional) - `message` (string, optional) - `metadata` (map from string to any, optional) - `status` (integer, optional) ## Types ### HarborActionGrantSchema - `field_ids` (list of string, required, nullable) — Unique input field IDs for a mutating operation, or output field IDs for a read-only operation. - `operation_id` (string, required) — Exact operation ID from operation discovery. - `schema_id` (string, required) — Exact action schema ID. - `lookup_field_ids` (list of string, optional) — Unique lookup field IDs for a read-only operation. Omit for a mutating operation. ### HarborActionConfigurationResponse - `connection_id` (string, optional) — Configured source Connection ID, including sources no longer attached to the Harbor. - `created_at` (datetime, optional) — When these grants were first created. - `grants` (list of HarborActionGrantSchema, optional, nullable) — Configured action permissions. - `revision` (string, optional) — Revision to supply when replacing or removing these grants. - `updated_at` (datetime, optional) — When these grants were last replaced. ## Examples **Request** ```json { "grants": [ { "field_ids": [ "customer_name", "order_id", "order_date" ], "operation_id": "createOrder", "schema_id": "ecommerceOrderSchema" } ] } ``` **Response** ```json { "data": [ { "connection_id": "248df4b7-aa70-47b8-a036-33ac447e668d", "created_at": "2024-01-15T09:30:00Z", "grants": [ { "field_ids": [ "customer_name", "order_id", "order_date" ], "operation_id": "createOrder", "schema_id": "ecommerceOrderSchema", "lookup_field_ids": [ "customer_id", "product_sku" ] } ], "revision": "a3f1c9d2-5b7e-4f8a-9c3d-2e7f1b6a9c4d", "updated_at": "2024-01-15T09:30:00Z" } ] } ``` **SDK Code** ```python import requests url = "https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d" payload = { "grants": [ { "field_ids": ["customer_name", "order_id", "order_date"], "operation_id": "createOrder", "schema_id": "ecommerceOrderSchema" } ] } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d'; const options = { method: 'PUT', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"grants":[{"field_ids":["customer_name","order_id","order_date"],"operation_id":"createOrder","schema_id":"ecommerceOrderSchema"}]}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d" payload := strings.NewReader("{\n \"grants\": [\n {\n \"field_ids\": [\n \"customer_name\",\n \"order_id\",\n \"order_date\"\n ],\n \"operation_id\": \"createOrder\",\n \"schema_id\": \"ecommerceOrderSchema\"\n }\n ]\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Put.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"grants\": [\n {\n \"field_ids\": [\n \"customer_name\",\n \"order_id\",\n \"order_date\"\n ],\n \"operation_id\": \"createOrder\",\n \"schema_id\": \"ecommerceOrderSchema\"\n }\n ]\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.put("https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"grants\": [\n {\n \"field_ids\": [\n \"customer_name\",\n \"order_id\",\n \"order_date\"\n ],\n \"operation_id\": \"createOrder\",\n \"schema_id\": \"ecommerceOrderSchema\"\n }\n ]\n}") .asString(); ``` ```php request('PUT', 'https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d', [ 'body' => '{ "grants": [ { "field_ids": [ "customer_name", "order_id", "order_date" ], "operation_id": "createOrder", "schema_id": "ecommerceOrderSchema" } ] }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d"); var request = new RestRequest(Method.PUT); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"grants\": [\n {\n \"field_ids\": [\n \"customer_name\",\n \"order_id\",\n \"order_date\"\n ],\n \"operation_id\": \"createOrder\",\n \"schema_id\": \"ecommerceOrderSchema\"\n }\n ]\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = ["grants": [ [ "field_ids": ["customer_name", "order_id", "order_date"], "operation_id": "createOrder", "schema_id": "ecommerceOrderSchema" ] ]] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://app.polytomic.com/api/harbors/248df4b7-aa70-47b8-a036-33ac447e668d/action-configuration/connections/248df4b7-aa70-47b8-a036-33ac447e668d")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PUT" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```