Tools - Ordinal Docs

Overview

Once connected, your assistant has access to the tools below. You don’t need to call them by hand — just ask in plain language (“draft a LinkedIn post for Friday,” “show me last month’s engagement”) and the assistant picks the right tool.

Always start with workspaces. If this is a new session, ask the assistant to “list my Ordinal workspaces” first. It needs to know which workspace you want before it can do anything else.

Discovery

Tool	What it does
`ordinal_get_workspace_context`	Lists your workspaces, then (once you pick one) returns the profiles, labels, and users the assistant needs to do everything else. The assistant requests only the sections it needs and can filter profiles by channel or name, so large workspaces stay within response limits.

Posts and ideas

Tool	What it does
`ordinal_search_content`	Searches posts or ideas — by status, labels, campaigns, or date — and can fetch a single post with its comments.
`ordinal_create_post`	Creates a post with LinkedIn, X, Instagram, TikTok, and/or YouTube Shorts content.
`ordinal_create_idea`	Creates an idea (a draft without a scheduled publish time).
`ordinal_manage_post`	Updates, archives, or unarchives a post.
`ordinal_manage_idea`	Updates, archives, unarchives, or adds an idea to the calendar.
`ordinal_list_post_versions`	Lists saved versions of a post’s draft per channel, with the author and timestamp of each.
`ordinal_get_post_version_content`	Reads the copy of a single saved version, so the assistant can diff two revisions or study how a draft evolved.

Media

Tool	What it does
`ordinal_create_upload`	Uploads an image or video from a URL, or prepares signed credentials so a local file can be uploaded.
`ordinal_get_upload`	Checks whether an upload is ready.

For a local file, the assistant calls ordinal_create_upload with filename, mimetype, and size, POSTs the file to the returned uploadUrl with params and signature, then polls ordinal_get_upload until status is ready.

Analytics

Tool	What it does
`ordinal_get_analytics`	Fetches post performance or follower growth for LinkedIn, X, Instagram, or Facebook.

Collaboration

Tool	What it does
`ordinal_list_approvals`	Shows who needs to approve a post and whether they’ve approved yet.
`ordinal_manage_approvals`	Requests or cancels approvals on a post.
`ordinal_list_subscribers`	Lists who’s subscribed to notifications on a post.
`ordinal_manage_subscribers`	Adds or removes subscribers.
`ordinal_manage_comments`	Adds a comment to a post or deletes one of your own.

Auto-engagements

Tool	What it does
`ordinal_list_engagements`	Lists automatic likes, comments, and reposts attached to a post.
`ordinal_manage_engagements`	Creates, updates, or removes auto-engagements.

Slack boosts

Tool	What it does
`ordinal_list_slack_boosts`	Lists Slack broadcasts attached to a post.
`ordinal_manage_slack_boosts`	Creates, updates, or deletes Slack boosts.

Labels

Tool	What it does
`ordinal_manage_labels`	Creates or deletes labels used to organize posts.

Platform utilities

Tool	What it does
`ordinal_get_linkedin_mention`	Looks up a LinkedIn user or company by username so it can be mentioned in a post.
`ordinal_get_linkedin_profile`	Fetches a LinkedIn profile by its URN.
`ordinal_search_instagram_locations`	Searches Instagram location tags to attach to posts.

Asking the assistant things

You don’t call these tools by name — you describe what you want. Examples:

“Create a LinkedIn post for next Tuesday about our new pricing, in the Launch campaign.”
“Archive the drafts I wrote last month that don’t have a label.”
“Show me which posts are waiting on approval from Sarah.”
“Give me the last 30 days of follower growth on LinkedIn.”
“Show me how the LinkedIn copy on this post changed between the last two saves.”

The assistant picks the tools, fills in the arguments, and shows you the result.

​Overview

​Discovery

​Posts and ideas

​Media

​Analytics

​Collaboration

​Auto-engagements

​Slack boosts

​Labels

​Platform utilities

​Asking the assistant things

Overview

Discovery

Posts and ideas

Media

Analytics

Collaboration

Auto-engagements

Slack boosts

Labels

Platform utilities

Asking the assistant things