Upsert integration action override

Administrator-only tenant overlay. action_key is one slash-free path segment including dots (for example synthetic.read). PUT permits flat disabled, manual_only, approval_tier and rate_limit. Unknown keys return 422, not 404. Approval/rate are checked against code defaults, not the preceding tenant restriction: lowering a previously tightened tier/rate back toward code is accepted; false resets flags and null clears nullable tier/rate. DELETE removes the stored row and restores code defaults; missing row returns 404. Thus today this is not a monotonic tighten-only tenant policy. Invalid values return a single error string, not field errors. Connected-app credentials are held by the integration provider and are not returned by any of these operations. ENG-5874 / ENG-5831 track consistent unknown-provider and field-level validation behavior; this documents current behavior.

PUT

api

accounts

{account_id}

integrations

settings

action

{action_key}

Upsert integration action override

curl --request PUT \
  --url https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "disabled": true,
  "manual_only": true,
  "rate_limit": 2
}
'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}"

payload = {
    "disabled": True,
    "manual_only": True,
    "rate_limit": 2
}
headers = {
    "api_access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({disabled: true, manual_only: true, rate_limit: 2})
};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"disabled\": true,\n  \"manual_only\": true,\n  \"rate_limit\": 2\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}"

	payload := strings.NewReader("{\n  \"disabled\": true,\n  \"manual_only\": true,\n  \"rate_limit\": 2\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("api_access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "action_key": "synthetic.read",
  "disabled": true,
  "manual_only": false,
  "approval_tier": null,
  "rate_limit": null
}

{
  "error": "<string>"
}

{
  "error": "trial_expired_locked",
  "message": "This workspace trial has ended. Restore billing from the billing page to continue."
}

{
  "error": "<string>"
}

Authorizations

api_access_token

string

header

required

This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.

Path Parameters

account_id

integer

required

Route account; caller must be a member.

action_key

string

required

One slash-free segment; dots are part of the key, not a format suffix.

Pattern: ^[^/]+$

Body

application/json

Flat JSON. Nested controller-name envelopes alone are ignored by current permit lists; unpermitted fields are ignored.

disabled

boolean

disabled: flat permitted field.

manual_only

boolean

manual only: flat permitted field.

approval_tier

enum<string> | null

approval tier: flat permitted field.

Available options:

none,

notify,

single_approver,

dual_control,

null

rate_limit

integer | null

rate limit: flat permitted field.

Required range: x >= 1

Response

Current response

action_key

string

required

action key from the current marketplace serializer.

disabled

boolean

required

disabled from the current marketplace serializer.

manual_only

boolean

required

manual only from the current marketplace serializer.

approval_tier

enum<string> | null

required

approval tier from the current marketplace serializer.

Available options:

none,

notify,

single_approver,

dual_control,

null

rate_limit

integer | null

required

rate limit from the current marketplace serializer.

Upsert integration action override

curl --request PUT \
  --url https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key} \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "disabled": true,
  "manual_only": true,
  "rate_limit": 2
}
'

import requests

url = "https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}"

payload = {
    "disabled": True,
    "manual_only": True,
    "rate_limit": 2
}
headers = {
    "api_access_token": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {api_access_token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({disabled: true, manual_only: true, rate_limit: 2})
};

fetch('https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["api_access_token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"disabled\": true,\n  \"manual_only\": true,\n  \"rate_limit\": 2\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tied.com/api/v1/accounts/{account_id}/integrations/settings/action/{action_key}"

	payload := strings.NewReader("{\n  \"disabled\": true,\n  \"manual_only\": true,\n  \"rate_limit\": 2\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("api_access_token", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "action_key": "synthetic.read",
  "disabled": true,
  "manual_only": false,
  "approval_tier": null,
  "rate_limit": null
}

{
  "error": "<string>"
}

{
  "error": "trial_expired_locked",
  "message": "This workspace trial has ended. Restore billing from the billing page to continue."
}

{
  "error": "<string>"
}

Getting started

Conversations

Contacts

Inboxes and channels

Automation and routing

Reporting

Help Center

Account and access

Orchestration Studio

Billing

Client API

Widget API

Receiving webhooks

Knowledge and model settings

Upsert integration action override

Authorizations

Path Parameters

Body

Response