Skip to main content

Find a record

Use search to open a workflow, run, environment, plan, or other saved record by name or ID. For operations that finished in this Desktop profile, follow notifications.

Search from Desktop

  1. Focus Search AkôFlow in the top bar, press /, or press ⌘K/Ctrl+K.
  2. Enter an ID, name, state or other indexed value.
  3. Select a result, or press Enter to open the first result.
  4. Press Escape to close search.

With an empty query, search shows quick navigation destinations. As you type, it shows matching records; select one to open its detail or list page.

Search covers:

TypeRepresentative indexed values
workflowID, external ID, name, namespace
executionID, title, resource/runtime IDs, failure and status
artifactID, name and version
environmentID, name, description and status
resourceID, name, provider, region, zone and type
planID, algorithm, objective, workflow version and scope
scopeID, name, topology and environment versions
materializationID, variant, digest, resource, run, activity, path and status

Exact matches appear before partial matches.

Search through the API

Complete API connection setup first.

curl --get --fail-with-body \
-H "Authorization: Bearer $AKOFLOW_API_TOKEN" \
--data-urlencode 'q=science' \
--data-urlencode 'types=workflow,execution,artifact' \
--data-urlencode 'limit=20' \
"$AKOFLOW_API_URL/search/"

The response shape is:

{
"query": "science",
"results": [
{
"type": "workflow",
"id": "science-workflow",
"title": "Science workflow",
"subtitle": "default",
"path": "/workflows/science-workflow",
"score": 0.9
}
],
"total": 1
}

limit defaults to 30 and is capped at 100. Omit types to search every supported type. Unknown type names are ignored; if every supplied name is unknown, the result is empty. An empty q returns an empty result without loading catalogs. A catalog failure returns 500 Internal Server Error.

When search returns nothing

  • Enter at least one non-whitespace character; an empty server query returns no entities.
  • Search uses the same catalogs as the list pages. If a catalog request fails, check the server connection and retry.
  • Use an exact ID when possible, or limit API results with types.