Updating a script

Scripts can be updated via a POST method to https://api.rebrandly.com/v1/scripts/:id, where :id is the unique identifier (id) of the script, which accepts a JSON object describing the Script.

🚧

Check compatibility first

Double check whether your API key or OAuth token is enabled to use the Scripts feature.
For every account, you can check for features and limits with a preliminary API call.

PATH Parameters

Path parameter

Description

id

Unique identifier of the script you want to update

Script Parameters

The table below shows the parameters you should specify when updating a script.
If you do not want to modify some parameters, you can simply leave them unchanged, i.e. pass their values as you originally received them.

Tag property

Type

Constraints

Description

name

string

required
UTF8
Min 3 chars
Max 255 chars

New name you want to assign to the script

value

string

required
Valid javascript code

Javascript snippet including opening and closing

Updating an existing script
$ curl 'https://api.rebrandly.com/v1/scripts/gewa4cc5b6ee45d6gkj65b06ac2d1hww' \
-X POST \
-H 'apikey: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d \
'{
  "name": "NewAlert",
  "value": "<script>alert('test');</script>"
}'

HTTP/1.1 200 OK
JSON response (updated script)
{
  "id": "gewa4cc5b6ee45d6gkj65b06ac2d1hww",
  "name": "NewAlert",
  "color": "<script>alert('test');</script>"
}

Handling errors

HTTP status

Error type

Description

403

403 - Invalid format

Invalid Link object. Double check value for property field. Details about validation failure in message field

404

404 - Not found
with property value "id"

Given id does not correspond to any existing script


Did this page help you?