Skip to content

Search apps

GET
/api/workspaces/{workspaceId}/apps/search
curl --request GET \
--url 'http://localhost:8080/api/workspaces/example/apps/search?q=example' \
--cookie auth_session=<auth_session>

Free-text search over each visible app’s title, description, path, owner and the warehouse tables its bindings read (FROM/JOIN identifiers in bindings/*.sql, indexed per push). Every term must match somewhere; results are ranked, best first, with the fields that matched.

workspaceId
required
string
q
required
string
<= 200 characters
limit
integer
>= 1 <= 100

Successful response

Media typeapplication/json
object
success

Whether the request succeeded.

boolean
data

Endpoint-specific response payload.

message
string
error
string

Example

{
"message": "Operation completed",
"error": "Error message"
}

Invalid request

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}

Internal server error

Media typeapplication/json
object
success
boolean
error
string

Example

{
"error": "Error message"
}