---
title: "Read workspace settings"
method: GET
path: "/api/v1/workspaces/{workspace_id}/settings"
tags: ["🏢 Workspaces"]
---

# Read workspace settings

`GET /api/v1/workspaces/{workspace_id}/settings`

## Request

- Base URL: `https://api.contentstudio.io`
- URL: `https://api.contentstudio.io/api/v1/workspaces/{workspace_id}/settings`
- Auth: API key in header `X-API-Key`

Returns every workspace-level setting the product exposes, plus the workspace's posting state and the number of scheduled posts currently held by a pause.

## Path parameters

- `workspace_id` string, required

## Response `200`

Workspace settings retrieved successfully

- object
  - `status` boolean
  - `message` string
  - `data` object
    - `id` string
    - `name` string
    - `slug` string
    - `logo` string, url
    - `timezone` string
    - `first_day` object
      - `day` string
      - `key` integer
    - `note` string, nullable
    - `instagram_posting_method` 'api' | 'mobile'
    - `company_name` string, nullable
    - `company_logo` string, url, nullable
    - `posting` object
      - `paused` boolean
      - `paused_posts_count` integer: Scheduled posts currently held by a pause. 0 when publishing is active.
      - `paused_at` string, date-time, nullable
      - `resumed_at` string, date-time, nullable
      - `changed_by` string, nullable

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - No access to this workspace. Workspace access refusals return `error_code` `WORKSPACE_ACCESS_DENIED`, `WORKSPACE_INVITATION_PENDING`, `WORKSPACE_LOCKED`.
- `404`: Workspace not found
- `429`: Too Many Requests - Rate limit exceeded

## Changes

- **2026-09-22** `ad0b687289a3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/changes/api/v1/workspaces/:workspace_id/settings/get.md)

---

[API](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1.md) - [All operations](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/contentstudio/apis/contentstudio-api-v1/revisions/2ce09d50369c?raw)