GET/spaces/api/v1/search.json

searches pages' title and content for text and return results

Query Params

Name
q
Type
string
required
Description
The search query.
Name
offset
Type
integer
Description
Name
limit
Type
integer
Description
Name
deleted
Type
boolean
Description
Specify whether or not to include deleted pages in the search.
Default
false
Name
spaceid
Type
array[integer]
Description
An array of spaceIDs to search within.
Default
all space ids user has access to
Format
Comma separated values
Name
fields
Type
array[string]
Description
Fields to search within.
Default
title content
Format
Comma separated values
Allowed values
- title
- content
- tags

Responses

Code
200
Type
object
Schema
Description
200 OK
SearchResponse is a wrapper for search results.
Code
500
Type
object
Schema
Description
500 Internal Server Error

Examples

200 OK

SearchResponse

{
  "included": {
    "spaces": {
      "additionalProp": {
        "LinkedCategory": {
          "category": {
            "id": 0,
            "meta": {},
            "type": "string"
          }
        },
        "banner": "string",
        "bannerX": 0,
        "bannerY": 0,
        "code": "string",
        "collaborators": [
          {
            "id": 0,
            "meta": {},
            "type": "string"
          }
        ],
        "collaboratorsCount": 0,
        "createdAt": "2025-01-29T11:35:39.245Z",
        "createdBy": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "deletedAt": "2025-01-29T11:35:39.245Z",
        "deletedBy": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "homepage": {
          "id": 0,
          "meta": {},
          "type": "string"
        },
        "icon": "string",
        "id": 0,
        "projectId": 0,
        "purpose": "string",
        "spaceColor": "string",
        "state": "string",
        "title": "string",
        "updatedAt": "2025-01-29T11:35:39.245Z",
        "updatedBy": {
          "id": 0,
          "meta": {},
          "type": "string"
        }
      }
    }
  },
  "results": [
    {
      "matched": {},
      "pageId": 0,
      "slug": "string",
      "space": {
        "id": 0,
        "type": "string"
      },
      "tags": [
        {
          "color": "string",
          "name": "string",
          "tagId": 0
        }
      ],
      "title": "string"
    }
  ],
  "totalResults": 0
}

Download Swagger