Query

workspaces

List all workspaces that the current API user has access to.

Paginated · weighted cost MCP: getWorkspaces

Arguments

after String default null: Cursor for fetching the next page of results.
first Int default 20: Number of workspaces to return (page size).

Returns

A paginated connection of Workspace nodes. See Pagination for the connection shape.

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

edges [WorkspaceEdge!]!: List of edges with cursors.
cursor String!: Cursor for this node.
node Workspace!: The workspace.
hashtags [Tag!]: Hashtags tracked for this workspace.
id ID!: Unique identifier for the tag in Archive's system.
name String!: The text of the tag.
provider Provider!: Platform where this tag was observed (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
type TagType!: Whether this tag is a HASHTAG or a MENTION.
HASHTAG: Hashtag tag (e.g. #archive)
MENTION: User mention tag (e.g. @archive)
id ID!: Unique identifier for the workspace (UUID format).
integrations [Integration!]!: Connected social accounts for this workspace. Distinct from mentions, which lists tracked terms (the @-handles Archive monitors); this field lists connected accounts, one entry per integration. Multiple integrations may share the same handle, and each entry carries its own status. Includes disconnected and failed integrations so you can detect broken connections.
connectedAt DateTimeWithZone!: Timestamp when the integration was first established (ISO 8601 UTC).
handle String!: Public-facing account handle for this integration (for example "support_testing"). Sourced from the associated mention tag.
id ID!: Stable unique identifier for this integration (UUID). Distinguishes multiple integrations that share the same handle.
provider Provider!: Platform on which this account is connected (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
status IntegrationStatus!: Lifecycle state of the integration. CONNECTED = active and verified; DISCONNECTED = the account was removed or the integration failed; PENDING = setup in progress.
CONNECTED: The integration is active and verified; Archive can fetch content for this account.
DISCONNECTED: The integration has been removed by the user or has failed and is no longer active. Archive cannot fetch new content for this account until it is reconnected.
PENDING: The integration is being established; initial verification or onboarding has not completed yet.
keywords [Keyword!]: Keywords tracked for this workspace (primarily YouTube). Distinct from hashtags and mentions, which surface Instagram/TikTok-style tags.
id ID!: Unique identifier for the keyword in Archive's system.
name String!: The exact phrase being tracked (for example "noodles worth loving"). Named name for consistency with Tag.name; backed by the keywords.value column.
provider Provider!: Platform on which this keyword is tracked (currently YOUTUBE; reserved for future providers).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
mentions [Tag!]: User mentions tracked for this workspace.
id ID!: Unique identifier for the tag in Archive's system.
name String!: The text of the tag.
provider Provider!: Platform where this tag was observed (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
type TagType!: Whether this tag is a HASHTAG or a MENTION.
HASHTAG: Hashtag tag (e.g. #archive)
MENTION: User mention tag (e.g. @archive)
name String!: Human-readable name of the workspace.
nodes [Workspace!]!: List of workspaces.
hashtags [Tag!]: Hashtags tracked for this workspace.
id ID!: Unique identifier for the tag in Archive's system.
name String!: The text of the tag.
provider Provider!: Platform where this tag was observed (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
type TagType!: Whether this tag is a HASHTAG or a MENTION.
HASHTAG: Hashtag tag (e.g. #archive)
MENTION: User mention tag (e.g. @archive)
id ID!: Unique identifier for the workspace (UUID format).
integrations [Integration!]!: Connected social accounts for this workspace. Distinct from mentions, which lists tracked terms (the @-handles Archive monitors); this field lists connected accounts, one entry per integration. Multiple integrations may share the same handle, and each entry carries its own status. Includes disconnected and failed integrations so you can detect broken connections.
connectedAt DateTimeWithZone!: Timestamp when the integration was first established (ISO 8601 UTC).
handle String!: Public-facing account handle for this integration (for example "support_testing"). Sourced from the associated mention tag.
id ID!: Stable unique identifier for this integration (UUID). Distinguishes multiple integrations that share the same handle.
provider Provider!: Platform on which this account is connected (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
status IntegrationStatus!: Lifecycle state of the integration. CONNECTED = active and verified; DISCONNECTED = the account was removed or the integration failed; PENDING = setup in progress.
CONNECTED: The integration is active and verified; Archive can fetch content for this account.
DISCONNECTED: The integration has been removed by the user or has failed and is no longer active. Archive cannot fetch new content for this account until it is reconnected.
PENDING: The integration is being established; initial verification or onboarding has not completed yet.
keywords [Keyword!]: Keywords tracked for this workspace (primarily YouTube). Distinct from hashtags and mentions, which surface Instagram/TikTok-style tags.
id ID!: Unique identifier for the keyword in Archive's system.
name String!: The exact phrase being tracked (for example "noodles worth loving"). Named name for consistency with Tag.name; backed by the keywords.value column.
provider Provider!: Platform on which this keyword is tracked (currently YOUTUBE; reserved for future providers).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
mentions [Tag!]: User mentions tracked for this workspace.
id ID!: Unique identifier for the tag in Archive's system.
name String!: The text of the tag.
provider Provider!: Platform where this tag was observed (for example INSTAGRAM, TIKTOK, YOUTUBE, or INTERNAL).
INSTAGRAM: Instagram platform integration, including posts, reels, stories, and profile data.
INTERNAL: Internal Archive-managed source used for synthetic or system-generated content.
TIKTOK: TikTok platform integration, including videos and creator profile data.
YOUTUBE: YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
type TagType!: Whether this tag is a HASHTAG or a MENTION.
HASHTAG: Hashtag tag (e.g. #archive)
MENTION: User mention tag (e.g. @archive)
name String!: Human-readable name of the workspace.
pageInfo PageInfo!: Pagination information.
endCursor String: Cursor for the last node in this page.
hasNextPage Boolean!: Whether there are more results after this page.
hasPreviousPage Boolean!: Whether there are results before this page.
startCursor String: Cursor for the first node in this page.
totalCount Int: Total number of items available.

query WorkspacesDefault($first: Int, $after: String) { workspaces(first: $first, after: $after) { totalCount edges { node { id name } } pageInfo { hasNextPage endCursor } } }

{ "data": { "workspaces": { "totalCount": 1, "edges": [ { "node": { "id": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a", "name": "Northwind Botanicals" } } ], "pageInfo": { "hasNextPage": false, "endCursor": "Z2lkOi8vYXJjaGl2ZS9Xb3Jrc3BhY2UvOTkwMTAx" } } } }