Skip to main content

Query Tools

Query tools are read‑only operations. They let AI agents fetch information without making any changes.

David Baum avatar
Written by David Baum
Updated this week

Use these to gather context or check the state of tasks, projects, asset or team members in your organization before taking action.

The ability to query agents, projects, workspaces, assets, and more means your automation can be intelligent and data‑driven.

Tool

Summary

Get agent credit balance

Return the remaining credit balance for your organisation.

Get agent credit ledger

Fetch the credit usage history with filters.

Get agent threads

Retrieve all conversation threads for an agent.

Get agent trigger sources

Return all event sources that trigger a given agent.

Get asset by external reference

Retrieve an asset using an external reference such as a Google Doc ID.

Get asset by ID

Fetch asset metadata, content and linked entities.

Get asset used in

Find where an asset is used (projects and workspaces).

Get assets for organization

Return all assets belonging to the organisation.

Get assets for project

List all assets linked to a project.

Get assets for workspace

Fetch assets shared at the workspace level.

Get collection assets

List assets contained in a collection.

Get comment by ID

Fetch details of a comment including content and author.

Get comments

Return comments on a task or project.

Get filtered tasks

Return tasks that match specific filters and view settings.

Get my projects

Return all projects assigned to the authenticated user.

Get note

Retrieve a note asset along with its relations.

Get organization by ID

Retrieve organisation details including name and configuration.

Get organization content pillars

List content pillars (themes) defined in the organisation.

Get organization content types

Return content types such as blog, video or podcast.

Get organization funnel stages

List funnel stages like TOFU, MOFU, BOFU.

Get organization labels

Fetch organisation‑wide labels for tagging projects, tasks or assets.

Get organization members

Return all users and their roles.

Get platform agents

List all available built‑in agents on the platform.

Get project

Fetch detailed information about a single project.

Get project collection projects

List projects in a specific collection.

Get project members

List all members on a project.

Get task by ID

Fetch full details of a task, including description and due dates.

Get tasks for organization

Return all tasks across the organisation.

Get tasks for project

List tasks belonging to a project.

Get user tasks

Retrieve tasks assigned to the authenticated user.

Get workspace

Retrieve information about a workspace by ID.

Get workspace members

Return all members of a workspace.

Get workspace roles

List roles defined within a workspace.

Query agents

Retrieve a list of agents with optional filters and relations.

Query organization

Fetch base information about your organisation (labels, pillars, content types).

Query workspace templates

List workspace templates without active workspaces.

Need More Help?

Didn't this information give you the answers you need? Chat with us in the Relato Slack Community or email us at [email protected]

Did this answer your question?