Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Search text in the suggestion title or description.",
"type": "string",
"minLength": 1,
"maxLength": 500
},
"forum_ids": {
"description": "Only suggestions in these forums.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"category_ids": {
"description": "Only suggestions in these categories.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"status_ids": {
"description": "Only suggestions with these public statuses (see uservoice_list_statuses).",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"no_status": {
"description": "Only suggestions without a public status.",
"type": "boolean"
},
"label_ids": {
"description": "Only suggestions with these labels.",
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"state": {
"description": "Only these states, e.g. [\"approved\",\"published\"] or [\"open\"].",
"minItems": 1,
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"enum": [
"published",
"approved",
"closed",
"for_review",
"deleted",
"merged",
"spam",
"new",
"filtered",
"open",
"active",
"inactive"
]
}
},
"created_after": {
"description": "Only suggestions created after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"
},
"created_before": {
"description": "Only suggestions created before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"
},
"updated_after": {
"description": "Only records updated after this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"
},
"updated_before": {
"description": "Only records updated before this time.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,6})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$"
},
"includes": {
"description": "Related records to sideload into `included`.",
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"enum": [
"forums",
"categories",
"statuses",
"labels",
"users",
"features",
"status_updates",
"supporter_messages"
]
}
},
"sort": {
"description": "Sort field, '-' prefix = descending, e.g. -created_at, -updated_at, -supporters_count.",
"type": "string",
"pattern": "^-?[a-z][a-z0-9_.]{0,63}$"
},
"per_page": {
"default": 20,
"description": "Records per page (1-100, default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "pagination.next_cursor from the previous page (same sort). Preferred over page.",
"type": "string",
"minLength": 1,
"maxLength": 2000,
"pattern": "^[\\x21-\\x7e]+$"
},
"page": {
"description": "Page number (1-based), when no cursor is used.",
"type": "integer",
"minimum": 1,
"maximum": 100000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}