---
title: "Global search across your company (agents, teams, people, projects, cards, wiki pages, sessions, cron jobs, webhook endpoints, files, integrations)"
method: GET
path: "/search"
tags: ["Search"]
---

# Global search across your company (agents, teams, people, projects, cards, wiki pages, sessions, cron jobs, webhook endpoints, files, integrations)

`GET /search`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/search`
- Auth: HTTP bearer

One query, twelve kinds, one flat list — what the application's ⌘K bar calls on every keystroke. Case- and accent-insensitive substring match on each kind's display name, at most 8 rows per kind, then `limit` overall. Scope is exactly what the caller can already list, kind by kind: agents (completed ones included, flagged `archived`), teams and members of your company; your OWN chat sessions only; webhook endpoints and cron jobs of your company's agents; projects (archived flagged), non-archived cards and wiki pages of your company; your OWN file library; integration connections of your company or created by you. Admin-only surfaces (audit log, dashboard) are never searched, so admin and member get the same shape. 404 (not 403) when you have no company.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

- object
  - `results` object[], required
    - `kind` 'agent' | 'team' | 'member' | 'session' | 'webhookEndpoint' | 'cronJob' | 'project' | 'card' | 'wikiPage' | 'file' | 'folder' | 'integration', required
    - `id` string, uuid, required
    - `label` string, required: The object's own name, never translated.
    - `context` string, nullable, required: A readable parent: the agent's team, a session's agent, a card's project and column.
    - `status` string, nullable, required: An enum value for the client to translate (agent status, project status, `blocked`, `enabled`/`disabled`, connection status).
    - `agentId` string, uuid: sessions, webhook endpoints, cron jobs
    - `projectId` string, uuid: cards, wiki pages
    - `archived` boolean: completed agent, archived session or project
    - `matchedContent` boolean: files, wiki pages, cards, projects: found in the content, not the name
    - `snippet` string, nullable: with `matchedContent`: a passage around the matched word
    - `updatedAt` string, date-time, nullable, required

## Other responses

- `400`: `q` missing, empty or longer than 80 characters; `limit` out of 1..100.
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: Not found, or the caller is not authorized to access this resource.

---

[API](https://skmtc.dev/atako/apis/atako-api.md) · [All operations](https://skmtc.dev/atako/apis/atako-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atako/apis/atako-api/revisions/aa555c56fbd7?raw)