Skip to main content
POST
/
api
/
v1
/
execution-tags
/
list
List all execution tags
curl --request POST \
  --url https://api.mentionlab.io/api/v1/execution-tags/list \
  --header 'Content-Type: application/json' \
  --header 'x-project-id: <x-project-id>' \
  --data '
{
  "name": "monthly-tagging",
  "sort": [
    {
      "field": "name",
      "direction": "ASC"
    }
  ]
}
'
{
  "page": {
    "totalRecords": 123,
    "limit": 123,
    "currentPage": 123,
    "totalPages": 123,
    "nextPage": 123,
    "prevPage": 123
  },
  "results": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "project": "a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
      "name": "important",
      "color": "#3B82F6"
    }
  ]
}

Headers

x-project-id
string
required

Project ID to specify the project context

Query Parameters

limit
integer
default:50
Required range: 1 <= x <= 1000
page
integer
default:1
Required range: x >= 1

Body

application/json
name
string

Case-insensitive partial match filter applied to the tag job execution name.

Example:

"monthly-tagging"

sort
object[]

Sorting options for the result set. Only the "name" field is sortable; defaults to ascending order by name.

Example:
[{ "field": "name", "direction": "ASC" }]

Response

page
object
required
results
object[]