Search channels

GET/search/channels

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Query parameters

qstringRequired
Search text. Messages support words, quoted phrases, OR and exclusions. Channels and members match literal substrings, ignoring case.
1 to 200 characters
cursorstring
Opaque next_cursor from the same search. Results are ordered by ID descending (UUIDv7 creation order).
Up to 1,000 characters
limitinteger
1 to 100 · Defaults to 20

Responses

200OK · ChannelSearchPage
400Bad requestInvalid search query or cursor

Plus the usual errors: 401, 403, 404.

curl "https://api.fryll.com/search/channels?q=deploy" \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID"

const res = await fetch(`https://api.fryll.com/search/channels?q=deploy`, {
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
  },
});
const data = await res.json();

Response200OK

{
  "next_cursor": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "items": [
    {
      "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
      "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
      "description": "Deploys and release notes",
      "visibility": "public",
      "name": "deploys"
    }
  ]
}

Search channels

GET/search/channels

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Query parameters

qstringRequired
Search text. Messages support words, quoted phrases, OR and exclusions. Channels and members match literal substrings, ignoring case.
1 to 200 characters
cursorstring
Opaque next_cursor from the same search. Results are ordered by ID descending (UUIDv7 creation order).
Up to 1,000 characters
limitinteger
1 to 100 · Defaults to 20

Responses

200OK · ChannelSearchPage
400Bad requestInvalid search query or cursor

Plus the usual errors: 401, 403, 404.

curl "https://api.fryll.com/search/channels?q=deploy" \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID"

const res = await fetch(`https://api.fryll.com/search/channels?q=deploy`, {
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
  },
});
const data = await res.json();

Response200OK

{
  "next_cursor": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "items": [
    {
      "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
      "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
      "description": "Deploys and release notes",
      "visibility": "public",
      "name": "deploys"
    }
  ]
}