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 tag’s dynamic 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.

{
	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}"
	}
}