Tags

Resource Fields

Name Type Read-only Description
name string

Metadata




 
 




Actions

Retrieve tags

GET /api/v1/users/:id/tags.json

Information

Allowed for Collaborators, Agents, Admins & Owners
Scope users

Response

    {
        "status": 200,
        "data": [
            {
    "id": 1,
    "name": "important",
    "resource_type": "tag"
}
        ],
        "resource": "tag",
        "total_count": 1
    }

Add tags

POST /api/v1/users/:id/tags.json

Information

Allowed for Collaborators, Agents, Admins & Owners
Scope users

Parameters

Name Type Mandatory Description
tags string
The comma separated values

Response

    {
        "status": 201,
        "data": [
            {
    "id": 1,
    "name": "important",
    "resource_type": "tag"
}
        ],
        "resource": "tag",
        "total_count": 1
    }

Replace tags

PUT /api/v1/users/:id/tags.json

Information

Allowed for Collaborators, Agents, Admins & Owners
Scope users

Parameters

Name Type Mandatory Description
tags string
The comma separated values

Response

    {
        "status": 200,
        "data": [
            {
    "id": 1,
    "name": "important",
    "resource_type": "tag"
}
        ],
        "resource": "tag",
        "total_count": 1
    }

Remove tags

DELETE /api/v1/users/:id/tags.json

Information

Allowed for Collaborators, Agents, Admins & Owners
Scope users

Arguments

Name Type Mandatory Description
tags string
The comma separated values

Response

    {
        "status": 200,
        "data": [
            {
    "id": 1,
    "name": "important",
    "resource_type": "tag"
}
        ],
        "resource": "tag",
        "total_count": 1
    }