list_insight_labels
List insight labels, optionally filtered by project.
List insight labels, optionally filtered by project.
Permissions
{
"ability": "mcp:read or mcp:write",
"role": "Team membership and applicable entity view policies are required.",
"plan": "The billing account must have the MCP entitlement. Writes also require a writable billing mode and applicable entity limits.",
"team": "The bearer token selects exactly one Team. Other team_id values cannot change the tenant."
}Input
{
"properties": {
"project_id": {
"description": "Optional project ID filter",
"type": "integer"
}
},
"type": "object"
}Output
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"project_id": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"color": {
"type": [
"string",
"null"
]
},
"order": {
"type": [
"integer",
"null"
]
}
},
"required": [
"id",
"project_id",
"name",
"color",
"order"
]
}
}
},
"required": [
"data"
]
}Examples
Request arguments
{}Result
{
"data": [
{
"id": 101,
"project_id": 1,
"name": "Usability",
"color": "gray",
"order": 1
}
]
}Errors
[
{
"status": 401,
"description": "Missing, expired, or revoked bearer token."
},
{
"status": 403,
"description": "Missing MCP ability, team membership, plan entitlement, or user permission."
},
{
"status": 404,
"description": "The MCP server is disabled."
},
{
"status": 429,
"description": "Rate limited; honor Retry-After before retrying."
},
{
"description": "Tool execution or validation failures are MCP error results. Inspect isError; a successful HTTP status alone does not indicate a successful tool call."
}
]An expired or revoked key cannot connect. A missing ability, role, feature entitlement, or team access prevents the operation. See authentication.