PUT
/
v1
/
url-groups
/
{id}
curl --request PUT \
  --url https://third-party.etrnl.app/v1/url-groups/{id} \
  --header 'API-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "customUrl": "<string>",
  "name": "<string>",
  "appName": "<string>"
}'
{
	success: true,
	err: '',
	group: {
		name: "Updated Group Name",
		appName: "ETRNL",
        organizationId: 33,
        creationDate: "2023-09-26T18:44:59.000Z",
		customUrl: "https://example.com/{tagId}/?enc={enc}&cmac={cmac}&eCode={eCode}"
	}
}

If tags have been programmed to this URL, you cannot make changes to the customUrl value. This would make deprogramming tags impossible as we wouldn’t be able to accurately identify the SUN parameters.


Headers

API-Key
string
required

Your organization’s private API key.

URL Params

id
string
required

The ID of the URL Group.

JSON Request Body

customUrl
string

The custom URL definition that will be programmed into the tags.

name
string

The name of your custom URL group.

appName
string

This is the service that’s used to add the custom URL. The custom URL group will show up in the programmer as [APP Name] - Name.