Bulk Update Bitlinks
bitly.bulk_update_bitlinks
ActionBusiness appsconnection required
Calls the Bitly API with the connection's credentials.
Archive, unarchive or retag up to 100 Bitlinks in one call, reporting which ids Bitly changed and which it left alone.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- OAuth 2.0
- Providers
- Bitly
- Secret shape
- {"access_token": "…"} — a Bitly generic access token, or {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
- Config it needs
- group_guid, domain, organization_guid
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
action Which bulk change to apply to every listed Bitlink. | string | Yes | — | one of "archive", "edit_tags" | — |
links The Bitlinks to change, as domain/hash ids; at most 100 per call. | array | Yes | — | array of string | ["bit.ly/2kZDMbT"] |
group_guid Bitly group to act in; overrides the connection's default group. | string | No | — | — | Ba1bc23dE4F |
archive For the archive action: true archives, false restores. | boolean | No | — | — | — |
add_tags For the edit_tags action: tags to add to every listed Bitlink. | array | No | — | array of string | — |
remove_tags For the edit_tags action: tags to strip from every listed Bitlink. | array | No | — | array of string | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"group_guid": "Ba1bc23dE4F",
"links": [
"bit.ly/2kZDMbT"
]
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
requested How many Bitlinks the call asked Bitly to change. | number | — |
updated How many Bitlinks Bitly reported as changed. | number | — |
updated_ids The Bitlink ids Bitly reported as changed. | array | — |
not_updated_ids Requested ids Bitly did not report back. | array | — |
partial True when some requested ids were not changed. | boolean | — |
group_guid The group the bulk update ran in. | string | — |
{
"group_guid": "",
"not_updated_ids": [],
"partial": false,
"requested": 0,
"updated": 0,
"updated_ids": []
}See Bulk Update Bitlinks run in a workflow.
In a technical demo we add the Bitly connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.