Skip to main content
POST
Sync agency Slack config

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Body

application/json

Bulk merge/replace Slack config across agency subaccounts. companyId is injected from the token.

targetCompanyIds
required

Explicit targets: the literal "all" for every subaccount, or a non-empty array of subaccount IDs. Empty array or missing => 400.

Available options:
all
webhooks
object[]

Webhook objects to merge/replace. Any invalid (non-Slack/Discord) URL => 400.

workflows
object[]

Workflow objects to merge/replace.

timeZone
string

IANA time zone to set for scheduled workflows.

deliverableMilestones
object

Config for deliverable-milestone notifications (which webhook, on/off).

mode
enum<string>
default:merge

"merge" (default) to append, "replace" to overwrite. In replace mode (without a deliverableMilestones-only payload) at least one valid webhook is required.

Available options:
merge,
replace

Response

Per-subaccount sync results.

data
object
required