POST
/
public
/
v1
/
submit
/
update_user_tag
Authorizations
Body
Enum options:
ACTIVITY_TYPE_UPDATE_USER_TAG
Timestamp (in milliseconds) of the request, used to verify liveness of user requests.
Unique identifier for a given Organization.
The parameters object containing the specific intent data for this activity.
Show details
Show details
A list of User IDs to add this tag to.
Show item details
Show item details
Array item type: string
item field
A list of User IDs to remove this tag from.
Show item details
Show item details
Array item type: string
item field
Response
A successful response returns the following fields:The activity object containing type, intent, and result
Show activity details
Show activity details
The intent of the activity
Show intent details
Show intent details
The updateUserTagIntent object
Show updateUserTagIntent details
Show updateUserTagIntent details
The new, human-readable name for the tag with the given ID.
A list of objects representing a particular User’s approval or rejection of a Consensus request, including all relevant metadata.
Copy
Ask AI
curl --request POST \
--url https://api.turnkey.com/public/v1/submit/update_user_tag \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header "X-Stamp: <string> (see Authorizations)" \
--data '{
"type": "ACTIVITY_TYPE_UPDATE_USER_TAG",
"timestampMs": "<string> (e.g. 1746736509954)",
"organizationId": "<string> (Your Organization ID)",
"parameters": {
"userTagId": "<string>",
"newUserTagName": "<string>",
"addUserIds": [
"<string>"
],
"removeUserIds": [
"<string>"
]
}
}'
Copy
Ask AI
{
"activity": {
"id": "<activity-id>",
"status": "ACTIVITY_STATUS_COMPLETED",
"type": "ACTIVITY_TYPE_UPDATE_USER_TAG",
"organizationId": "<organization-id>",
"timestampMs": "<timestamp> (e.g. 1746736509954)",
"result": {
"activity": {
"id": "<string>",
"organizationId": "<string>",
"status": "<string>",
"type": "<string>",
"intent": {
"updateUserTagIntent": {
"userTagId": "<string>",
"newUserTagName": "<string>",
"addUserIds": [
"<string>"
],
"removeUserIds": [
"<string>"
]
}
},
"result": {
"updateUserTagResult": {
"userTagId": "<string>"
}
},
"votes": "<array>",
"fingerprint": "<string>",
"canApprove": "<boolean>",
"canReject": "<boolean>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
}
}
}