---
title: "API Reference"
url: "https://rolebase.io/en/api"
---

[Rolebase](/) ⟩ [API Reference](/en/api)

# API Reference

Access and manage your Rolebase organizations programmatically through the GraphQL API.

## API Keys

Generate API keys for your organization at [/apps](/apps). These keys authenticate all requests to the API.

## GraphQL Endpoint

**Production:** `https://api.rolebase.io/graphql`

**Local development:** `http://localhost:8888/graphql`

The API is powered by [Hasura](https://hasura.io/docs/2.0/index/), so you can refer to the Hasura documentation for advanced query capabilities.

## Quick Start

### Using curl

```
curl -X POST https://api.rolebase.io/graphql \
  -H "x-api-key: YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"query": "{ org { id, name } }"}'
```

### Using Apollo Client

```
import {
  ApolloClient,
  InMemoryCache,
  createHttpLink,
  gql,
} from '@apollo/client'

// Create the client with auth headers
const client = new ApolloClient({
  link: createHttpLink({
    uri: 'https://api.rolebase.io/graphql',
    headers: {
      'x-api-key': 'YOUR_API_KEY_HERE',
    },
  }),
  cache: new InMemoryCache(),
})

// Example query
const { data } = await client.query({
  query: gql`
    query GetOrganization {
      org {
        id
        name
      }
    }
  `,
})
```

** Authentication**

Include the `x-api-key` header in every request. Your API key determines which organization data you can access and what operations are permitted.

## Entities

Each entity supports standard GraphQL operations (query, mutation) depending on your API key permissions.

### Organization & Members

*   [`org`](/en/api/org) — Organizations
*   [`member`](/en/api/member) — Organization members
*   [`org_file`](/en/api/org_file) — Organization files
*   [`org_subscription`](/en/api/org_subscription) — Organization subscriptions

### Circles & Roles

*   [`circle`](/en/api/circle) — Organizational circles
*   [`circle_leader`](/en/api/circle_leader) — Circle leadership assignments
*   [`circle_link`](/en/api/circle_link) — Links between circles
*   [`circle_member`](/en/api/circle_member) — Circle memberships
*   [`circle_participant`](/en/api/circle_participant) — Circle participants (view)
*   [`role`](/en/api/role) — Roles within circles

### Meetings

*   [`meeting`](/en/api/meeting) — Meetings
*   [`meeting_attendee`](/en/api/meeting_attendee) — Meeting attendees
*   [`meeting_recurring`](/en/api/meeting_recurring) — Recurring meeting configurations
*   [`meeting_step`](/en/api/meeting_step) — Meeting steps and agenda items
*   [`meeting_template`](/en/api/meeting_template) — Meeting templates