> ## Documentation Index
> Fetch the complete documentation index at: https://ordinal.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ordinal API

> Programmatically manage your Ordinal workspace with the REST API

## Overview

The Ordinal API allows you to programmatically create and manage posts, profiles, approvals, labels, and analytics data within your workspace. The API follows REST conventions and uses JSON for request and response bodies.

> [card] Base URL
>
> ```
> https://app.tryordinal.com/api/v1
> ```

## Quick Start

> [!NOTE]
>
> **Pro Plan Required**
>
> The Ordinal API is available on the Pro plan or higher. [Upgrade your workspace](https://app.tryordinal.com/settings/pricing) to access API features.

**1. Generate an API Key**

Navigate to your workspace settings and create a new API key. See the [Authentication](https://ordinal.mintlify.site/api/authentication.md) guide for details.

**2. Make Your First Request**

Use the API key as a Bearer token to authenticate your requests:

We recommend testing the [Get Workspace](https://ordinal.mintlify.site/api-reference/workspaces/get-workspace.md) endpoint to confirm that your API key is working.

```bash theme={null}
curl -X GET "https://app.tryordinal.com/api/v1/workspace" \
  -H "Authorization: Bearer your_api_key"
```

Confirm that you see your workspace information in the response.

```json theme={null}
{
  "id": "your-workspace-uuid",
  "name": "Your Workspace",
  "slug": "your-workspace",
  "timezone": "America/New_York",
  "createdAt": "2025-01-01T00:00:00.000Z"
}
```

**3. Explore Endpoints**

Browse the endpoint documentation to discover all available operations for posts, profiles, approvals, and more.

## Available Resources

> [card] [Posts](https://ordinal.mintlify.site/api-reference/posts/list-posts.md)
>
> Create, list, retrieve, archive, and unarchive posts in your workspace

> [card] [File Uploads](https://ordinal.mintlify.site/api-reference/file-uploads/upload-a-file-from-a-url.md)
>
> Upload files from URLs to attach to posts

> [card] [Profiles](https://ordinal.mintlify.site/api-reference/profiles/list-scheduling-profiles.md)
>
> List scheduling and engagement profiles connected to your workspace

> [card] [Approvals](https://ordinal.mintlify.site/api-reference/approvals/create-approval-requests.md)
>
> Manage approval workflows for posts

> [card] [Labels](https://ordinal.mintlify.site/api-reference/labels/list-all-labels.md)
>
> Create and manage labels for organizing posts

> [card] [Subscribers](https://ordinal.mintlify.site/api-reference/subscribers/list-post-subscribers.md)
>
> Manage post subscribers for notifications

> [card] [Comments](https://ordinal.mintlify.site/api-reference/comments/list-post-comments.md)
>
> List and create comments on posts with @mention support

> [card] [Inline Comments](https://ordinal.mintlify.site/api-reference/inline-comments/list-inline-comments-on-a-post.md)
>
> Retrieve text-anchored comments on post content

> [card] [Invites](https://ordinal.mintlify.site/api-reference/invites/list-pending-invites.md)
>
> Invite users to your workspace via email

> [card] [Analytics](https://ordinal.mintlify.site/api-reference/analytics/get-cpm-values.md)
>
> Retrieve post and follower analytics across platforms

> [card] [Webhooks](https://ordinal.mintlify.site/api-reference/webhooks/list-webhooks.md)
>
> Create, list, get, update, and delete webhooks to receive real-time event notifications

> [card] [Slack Boosts](https://ordinal.mintlify.site/api-reference/slack-boosts/create-slack-boost.md)
>
> List Slack channels, then create, list, get, update, and delete Slack Boosts for posts

## Rate Limiting

API requests are rate limited to ensure fair usage of 100 requests per minute per workspace. The limit is shared across all API keys in a workspace. When you exceed the rate limit, you'll receive a `429 Too Many Requests` response with information about when your quota resets.

```json theme={null}
{
  "code": "TOO_MANY_REQUESTS",
  "message": "Rate limit of 100 requests per 60s exceeded. Quota resets in 45 seconds"
}
```

If you need a higher rate limit, please reach out to support.

## Need Help?

> [card] [Authentication](https://ordinal.mintlify.site/api/authentication.md)
>
> Learn how to authenticate your API requests

> [card] [Error Handling](https://ordinal.mintlify.site/api/errors.md)
>
> Understand API error responses


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.