> ## 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 Agency API

> Programmatically manage multiple workspaces with the Agency API

> [!WARNING]
>
> **Looking for the Workspace API?**
>
> This is the **Agency API** for managing multiple workspaces at the company level. If you want to create posts, manage profiles, or access workspace-specific resources, see the [Workspace API](https://ordinal.mintlify.site/api/introduction.md) instead.

## Overview

The Ordinal Agency API allows agencies and teams to programmatically manage multiple workspaces from a single company account. With company-level API access, you can create new workspaces, manage workspace API keys, and automate your multi-client workflows.

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

## Use Cases

The Agency API is designed for:

* **Agencies** managing social media for multiple clients, each with their own workspace
* **Enterprises** with multiple brands or business units
* **Platforms** building integrations that provision Ordinal workspaces for their users

## Quick Start

> [!NOTE]
>
> **Enterprise Plan Required**
>
> The Agency API requires an Enterprise plan. [Contact sales](mailto:sales@tryordinal.com) to upgrade your account.

**1. Generate a Company API Key**

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

**2. Make Your First Request**

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

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

Confirm that you see your workspaces in the response.

```json theme={null}
{
  "workspaces": [
    {
      "id": "workspace-uuid-1",
      "name": "Client A",
      "slug": "client-a",
      "timezone": "America/New_York",
      "createdAt": "2025-01-01T00:00:00.000Z"
    },
    {
      "id": "workspace-uuid-2",
      "name": "Client B",
      "slug": "client-b",
      "timezone": "Europe/London",
      "createdAt": "2025-02-01T00:00:00.000Z"
    }
  ]
}
```

**3. Explore Endpoints**

Browse the endpoint documentation to discover all available operations for managing workspaces and API keys.

## Available Operations

> [card] [List Workspaces](https://ordinal.mintlify.site/agency-api-reference/workspaces/list-workspaces.md)
>
> List all workspaces in your company

> [card] [Create Workspace](https://ordinal.mintlify.site/agency-api-reference/workspaces/create-workspace.md)
>
> Create a new workspace for a client

> [card] [Get Workspace](https://ordinal.mintlify.site/agency-api-reference/workspaces/get-workspace.md)
>
> Retrieve details of a specific workspace

> [card] [Manage API Keys](https://ordinal.mintlify.site/agency-api-reference/api-keys/create-workspace-api-key.md)
>
> Create and list workspace API keys programmatically

## Agency API vs Workspace API

| Feature | Agency API | Workspace API |
| - | - | - |
| **Scope** | All workspaces in your company | Single workspace |
| **Key prefix** | `ord_c_*` | `ord_*` |
| **Create workspaces** | Yes | No |
| **Manage workspace API keys** | Yes | No |
| **Access posts and profiles** | No (use workspace keys) | Yes |

> [!TIP]
>
> Use the Agency API to create workspaces and generate workspace API keys. Then use those workspace API keys with the [Workspace API](https://ordinal.mintlify.site/api/introduction.md) to manage posts, profiles, and other workspace-specific resources.

## Rate Limiting

API requests are rate limited to ensure fair usage. The Agency API has a limit of 100 requests per minute per API key.

```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/agency-api/authentication.md)
>
> Learn how to authenticate your Agency 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.