API Reference
Status Check
Accounts
Workspaces
Workspace users
Workspace domains
Workspace pages
Workspace sections
Workspace plan tasks
Retrieve a list of tags
Retrieve a list of tags
curl --request GET \
--url https://api.dock.so:4000/{version}/tags \
--header 'Authorization: Bearer <token>'
{
"data": {
"tags": [
{
"id": "RiHO4e0Ju3DS",
"updatedAt": "2021-01-01T00:00:00.000Z",
"createdAt": "2021-01-01T00:00:00.000Z",
"object": "tag",
"url": "https://api.dock.us/v1/tags/RiHO4e0Ju3DS",
"title": "Logo",
"boards": [
{
"id": "RiHO4e0Ju3DS",
"updatedAt": "2021-01-01T00:00:00.000Z",
"createdAt": "2021-01-01T00:00:00.000Z",
"object": "board",
"url": "https://api.dock.us/v1/boards/RiHO4e0Ju3DS",
"title": "Sales",
"appearance": "greyExtraLight",
"icon": "🚀",
"description": "Sales leads"
}
]
}
],
"pageInfo": {
"page": 1,
"pages": 10,
"total": 100,
"pageTotal": 10,
"hasNextPage": true,
"hasPrevPage": false
}
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Page number
Number of results to return
Select the tag properties that should be returned
title
, createdAt
, updatedAt
, boards.title
, boards.createdAt
, boards.updatedAt
, boards.icon
, boards.appearance
, boards.description
Response
Id of the object
"RiHO4e0Ju3DS"
Last updated date
"2021-01-01T00:00:00.000Z"
Created at date
"2021-01-01T00:00:00.000Z"
Type of the object
tag
"tag"
URL to the resource
"https://api.dock.us/v1/tags/RiHO4e0Ju3DS"
Title of the tag
"Logo"
Boards of the tag
Id of the object
"RiHO4e0Ju3DS"
Last updated date
"2021-01-01T00:00:00.000Z"
Created at date
"2021-01-01T00:00:00.000Z"
Type of the object
board
"board"
URL to the resource
"https://api.dock.us/v1/boards/RiHO4e0Ju3DS"
Title of the board
"Sales"
Appearance of the board
greyExtraLight
, mandy
, saffron
, conifer
, pastelGreen
, downy
, malibu
, royalBlue
, mediumPurple
, brilliantRose
"greyExtraLight"
Icon of the board
"🚀"
Description of the board
"Sales leads"
Current page number
1
Total number of pages
10
Total number of items
100
Number of items on the current page
10
Whether there is a next page
true
Whether there is a previous page
false
curl --request GET \
--url https://api.dock.so:4000/{version}/tags \
--header 'Authorization: Bearer <token>'
{
"data": {
"tags": [
{
"id": "RiHO4e0Ju3DS",
"updatedAt": "2021-01-01T00:00:00.000Z",
"createdAt": "2021-01-01T00:00:00.000Z",
"object": "tag",
"url": "https://api.dock.us/v1/tags/RiHO4e0Ju3DS",
"title": "Logo",
"boards": [
{
"id": "RiHO4e0Ju3DS",
"updatedAt": "2021-01-01T00:00:00.000Z",
"createdAt": "2021-01-01T00:00:00.000Z",
"object": "board",
"url": "https://api.dock.us/v1/boards/RiHO4e0Ju3DS",
"title": "Sales",
"appearance": "greyExtraLight",
"icon": "🚀",
"description": "Sales leads"
}
]
}
],
"pageInfo": {
"page": 1,
"pages": 10,
"total": 100,
"pageTotal": 10,
"hasNextPage": true,
"hasPrevPage": false
}
}
}