Saltar al contenido principal
GET
/
search
Buscar Recursos del Tenant
curl --request GET \
  --url https://api.altostrat.io/search \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "doc_1",
      "name": "Documentación del Proyecto Alpha",
      "type": "document",
      "description": "Documentación completa para el proyecto Alpha que incluye especificaciones de la API y guías de usuario.",
      "org_id": "org_MyoAolMD2GACSFi8",
      "workspace_id": "ws_sz47boIRd2XfDRk3G0",
      "metadata": {
        "category": "técnico",
        "resource_id": "res_doc_001"
      },
      "created_at": "2025-10-24T12:00:00.000000Z",
      "updated_at": "2025-10-27T15:30:00.000000Z",
      "relevance_percentage": 100,
      "scout_score": 123456789
    }
  ],
  "links": {
    "first": "https://api.altostrat.io/search?page=1",
    "last": "https://api.altostrat.io/search?page=5",
    "prev": null,
    "next": "https://api.altostrat.io/search?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 5,
    "path": "https://api.altostrat.io/search",
    "per_page": 20,
    "to": 20,
    "total": 95
  }
}

Authorizations

​
Authorization
string
header
required

Las APIs de Altostrat utilizan tokens JWT Bearer para la autenticación.

Query Parameters

​
q
string
required

La cadena de consulta de búsqueda principal. La API realiza una búsqueda aproximada (fuzzy) en nombres de recursos, descripciones y metadatos.

Required string length: 1 - 255
​
workspace_id
string

Un filtro opcional para limitar los resultados de la búsqueda a un ID de espacio de trabajo (workspace) específico. Si se proporciona, se ignora org_id. Si se omite, la búsqueda se realiza por defecto en el ámbito de la organización.

​
org_id
string

Un filtro opcional para limitar los resultados de la búsqueda a un ID de organización específico. Generalmente es utilizado por usuarios administradores para buscar fuera de su organización predeterminada. Si se omite, la búsqueda se limita a la organización del usuario autenticado.

​
types
string[]

Un array de tipos de entidad para filtrar los resultados. Por ejemplo, types[]=device&types[]=policy solo devolverá entidades de esos dos tipos.

​
created_from
string<date>

La fecha de inicio para un filtro de rango de fechas de creación, en formato AAAA-MM-DD.

​
created_to
string<date>

La fecha de fin para un filtro de rango de fechas de creación, en formato AAAA-MM-DD.

​
page
integer
default:1

El número de página para la paginación.

Required range: x >= 1
​
per_page
integer
default:20

El número de resultados a devolver por página.

Required range: 1 <= x <= 100

Response

Una lista paginada de resultados de búsqueda.

​
data
object[]
​
links
object
​
meta
object