Skip to main content
GET
Get general workflows metadata for a space
The organization bot token must have the following scopes:
  • workflows:read

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The Admin API version to use for this request.

Available options:
2026-06-01

Path Parameters

space_id
string<uuid>
required

Query Parameters

created_by_ids
string<uuid>[]

User IDs of agent creators to filter by.

created_time_from
string

Inclusive lower bound on 'created_time', as epoch-millisecond digits. Requests with non-numeric values return a validation error.

created_time_to
string

Inclusive upper bound on 'created_time', as epoch-millisecond digits. Requests with non-numeric values return a validation error.

credit_usage_time_from
string

Epoch ms, inclusive. When either bound is set, an agent is returned only if its latest credit usage is inside the [from, to] window; agents with no in-window usage are excluded entirely, and 'last_credit_usage_time' reflects the most recent credit usage of the agent.

credit_usage_time_to
string

Epoch ms, inclusive. See 'credit_usage_time_from' for the window semantics.

cursor
string

Pagination cursor returned from a previous response's 'next_cursor'.

integration_types
string[]

Integration types to filter by, such as "slack", "github", or "mcpServer".

mcp_server_names
string[]

MCP server names to filter by.

models
string[]

Agent models to filter by. Accepts model display names (such as "Claude 4 Sonnet") as shown in the response 'model' field.

name
string

Case-insensitive substring match against the agent name or description. Every other string filter uses exact matching against its target field values.

shared_with_group_ids
string<uuid>[]

Filter to agents shared with any of these group IDs. Matches custom agents only: database (autofill) agents are excluded whenever this filter is set, since their sharing state is not exposed.

shared_with_user_ids
string<uuid>[]

Filter to agents shared with any of these user IDs. Matches custom agents only: database (autofill) agents are excluded whenever this filter is set, since their sharing state is not exposed.

status
enum<string>[]

Status filter. Accepts every response status value, plus the "disabled" convenience bucket for admin-disabled agents.

Available options:
active,
credit_limit,
deleted,
disabled,
disabled_by_notion,
disabled_due_to_lack_of_editors,
disabled_due_to_lack_of_full_access_members,
disabled_from_agent_settings,
disabled_from_api,
disabled_from_workspace_settings,
failure_limit,
internal_error,
mark_session_failed_autopause,
needs_review,
run_limit,
runaway_credit_usage,
tool_unavailable,
workspace_credit_limit

Response

has_more
boolean
required
results
object[]
required

The page of agents matching the filters, up to 25. Permanently deleted tombstones are excluded.

next_cursor
string