Spaces

What are Spaces?

Spaces are organizational units within a Network where content and members are organized. Think of them as communities, groups, or channels within your larger Network. Spaces help you:

Organize content by topic or purpose
Control access and permissions
Create focused communities within your Network
Manage members at a granular level

Space Properties

Each space includes:

Space ID - Unique identifier for the space
Name - Display name of the space
Visibility - Public, private, or secret
Members - Users who have access to this space
Posts - Content created within the space
Settings - Configuration for moderation, features, etc.

Listing Spaces

Get all spaces in your Network:

curl https://api.mn.co/admin/v1/networks/{network_id}/spaces \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const response = await fetch(
  `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/spaces`,
  {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  }
);

const spaces = await response.json();
console.log(spaces.items);

response = requests.get(
    f"https://api.mn.co/admin/v1/networks/{NETWORK_ID}/spaces",
    headers={"Authorization": f"Bearer {API_TOKEN}"}
)

spaces = response.json()
print(spaces['items'])

Example Response

{
  "items": [
    {
      "id": 12345,
      "name": "General Discussion",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-03-20T14:22:00Z"
    },
    {
      "id": 12346,
      "name": "Announcements",
      "created_at": "2024-01-15T10:35:00Z",
      "updated_at": "2024-03-19T09:15:00Z"
    }
  ],
  "links": {
    "self": "https://api.mn.co/admin/v1/networks/123/spaces?page=1",
    "next": "https://api.mn.co/admin/v1/networks/123/spaces?page=2"
  }
}

Getting a Specific Space

Retrieve details about a single space:

curl https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id} \
  -H "Authorization: Bearer YOUR_API_TOKEN"

const response = await fetch(
  `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/spaces/${SPACE_ID}`,
  {
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`
    }
  }
);

const space = await response.json();

response = requests.get(
    f"https://api.mn.co/admin/v1/networks/{NETWORK_ID}/spaces/{SPACE_ID}",
    headers={"Authorization": f"Bearer {API_TOKEN}"}
)

space = response.json()

Space Membership

Listing Members in a Space

Get all members who have access to a specific space:

curl https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id}/members \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Adding Members to a Space

Add a user to a space:

curl -X POST https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id}/members?user_id={user_id} \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Removing Members from a Space

Remove a user from a space:

curl -X DELETE https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id}/members/{user_id}/ \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Space Roles

Members can have different roles within a space:

Host - Can manage space settings, content, and members
Member - Standard access to view and create content
Moderator - Can moderate content but not change settings

Updating Member Roles

Change a member’s role in a space:

curl -X PATCH https://api.mn.co/admin/v1/networks/{network_id}/spaces/{space_id}/members/{user_id}/ \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"role": "host"}'

const response = await fetch(
  `https://api.mn.co/admin/v1/networks/${NETWORK_ID}/spaces/${SPACE_ID}/members/${USER_ID}/`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${API_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ role: 'host' })
  }
);

Common Use Cases

Bulk Member Assignment

Add multiple users to a space:

async function addMembersToSpace(networkId, spaceId, userIds, apiToken) {
  const results = [];

  for (const userId of userIds) {
    try {
      const response = await fetch(
        `https://api.mn.co/admin/v1/networks/${networkId}/spaces/${spaceId}/members?user_id=${userId}`,
        {
          method: 'POST',
          headers: { 'Authorization': `Bearer ${apiToken}` }
        }
      );

      if (response.ok) {
        results.push({ userId, success: true });
      }
    } catch (error) {
      results.push({ userId, success: false, error: error.message });
    }
  }

  return results;
}

Space Analytics

Get member count for each space:

async function getSpaceAnalytics(networkId, apiToken) {
  const spacesResponse = await fetch(
    `https://api.mn.co/admin/v1/networks/${networkId}/spaces`,
    { headers: { 'Authorization': `Bearer ${apiToken}` } }
  );

  const spaces = await spacesResponse.json();

  const analytics = [];
  for (const space of spaces.items) {
    const membersResponse = await fetch(
      `https://api.mn.co/admin/v1/networks/${networkId}/spaces/${space.id}/members`,
      { headers: { 'Authorization': `Bearer ${apiToken}` } }
    );

    const members = await membersResponse.json();
    analytics.push({
      spaceName: space.name,
      memberCount: members.items?.length || 0
    });
  }

  return analytics;
}

Automated Space Assignment

Automatically assign new members to a default space:

async function assignToDefaultSpace(networkId, spaceId, newMemberId, apiToken) {
  const response = await fetch(
    `https://api.mn.co/admin/v1/networks/${networkId}/spaces/${spaceId}/members?user_id=${newMemberId}`,
    {
      method: 'POST',
      headers: { 'Authorization': `Bearer ${apiToken}` }
    }
  );

  if (!response.ok) {
    throw new Error(`Failed to add member to space: ${response.statusText}`);
  }

  return await response.json();
}

Best Practices

Organize Content Logically - Use spaces to group related content and discussions
Manage Permissions Carefully - Consider who should have access to each space
Use Pagination - Always paginate when listing space members
Handle Errors - Check for 404 errors if a space doesn’t exist
Respect Rate Limits - Be mindful when performing bulk operations across spaces

Next Steps

Members

Learn about member management and roles.

Posts

Understand how to work with posts and content.

Networks

Learn about network-level operations.

Admin API

Explore all space-related endpoints.

Getting started

Key Concepts

What are Spaces?

Space Properties

Listing Spaces

Example Response

Getting a Specific Space

Space Membership

Listing Members in a Space

Adding Members to a Space

Removing Members from a Space

Space Roles

Updating Member Roles

Common Use Cases

Bulk Member Assignment

Space Analytics

Automated Space Assignment

Best Practices

Next Steps

Members

Posts

Networks

Admin API

​What are Spaces?

​Space Properties

​Listing Spaces

​Example Response

​Getting a Specific Space

​Space Membership

​Listing Members in a Space

​Adding Members to a Space

​Removing Members from a Space

​Space Roles

​Updating Member Roles

​Common Use Cases

​Bulk Member Assignment

​Space Analytics

​Automated Space Assignment

​Best Practices

​Next Steps

Members

Posts

Networks

Admin API

What are Spaces?

Space Properties

Listing Spaces

Example Response

Getting a Specific Space

Space Membership

Listing Members in a Space

Adding Members to a Space

Removing Members from a Space

Space Roles

Updating Member Roles

Common Use Cases

Bulk Member Assignment

Space Analytics

Automated Space Assignment

Best Practices

Next Steps