DoiT

DoiT Settings API

The Settings API from DoiT — 3 operation(s) for settings.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /analytics/v1/settings/themes List custom color themes · List custom themes #
Ask an LLM
“Which custom color themes are defined for our account?”
“Can I see all our chart color themes?”
Tell an agent
List all custom themes.
Show our custom color themes.
POST /analytics/v1/settings/themes Create a custom color theme · Create a custom theme #
Ask an LLM
“How do I create a chart color theme in our brand colors?”
“What permission do I need to add a custom theme?”
Tell an agent
Create theme {name} with primary color {primaryColor} and colors {colors}.
Add a custom theme {name} using palette {colors} and primary {primaryColor}.
GET /analytics/v1/settings/themes/{id} Retrieve a custom theme · Retrieve a custom theme #
Ask an LLM
“How do I see the colors in one custom theme?”
“Can I fetch a theme by its ID?”
Tell an agent
Get custom theme {id}.
Show the palette of theme {id}.
PATCH /analytics/v1/settings/themes/{id} Edit a custom theme · Update a custom theme #
Ask an LLM
“How do I change the colors in an existing theme?”
“Can I rename a custom theme?”
Tell an agent
Change theme {id} primary color to {primaryColor}.
Rename custom theme {id} to {name}.
DELETE /analytics/v1/settings/themes/{id} Delete a custom theme · Delete a custom theme #
Ask an LLM
“How do I delete a color theme we don't use?”
“Who is allowed to delete custom themes?”
Tell an agent destructive · confirm first
Delete custom theme {id}.
Remove theme {id}.
GET /analytics/v1/settings/active-theme See my active theme · Get the active theme #
Ask an LLM
“Which color theme am I currently using?”
“Am I on the default theme or a custom one?”
Tell an agent
Get my active theme.
Tell me which theme is active for me.
PUT /analytics/v1/settings/active-theme Switch my active theme · Set the active theme #
Ask an LLM
“How do I switch to a different color theme?”
“Can I go back to the default theme?”
Tell an agent
Set my active theme to {themeId}.
Switch me to theme {themeId}.

Documentation

📖
Documentation
https://developer.doit.com/docs/start
📖
APIReference
https://developer.doit.com/reference/welcome
📖
GettingStarted
https://developer.doit.com/docs/start
📖
Authentication
https://artifacts.apis.io/doit/authentication/doit-authentication.yml
📖
RateLimits
https://artifacts.apis.io/doit/rate-limits/doit-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/doit/openapi/doit-settings-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://artifacts.apis.io/doit/scopes/doit-scopes.yml
🔗
ErrorCatalog
https://artifacts.apis.io/doit/errors/doit-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/doit/data-model/doit-data-model.yml
🔗
Conventions
https://artifacts.apis.io/doit/conventions/doit-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/doit:doit-settings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

doit-settings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: DoiT Settings API
  description: Programmatic access to DoiT Platform
  version: v1
servers:
- url: https://api.doit.com
security:
- api_key: []
- tenantId: []
  api_key: []
tags:
- name: Settings
paths:
  /analytics/v1/settings/themes:
    get:
      tags:
      - Settings
      summary: List custom themes
      description: Returns the list of custom color themes defined for your account.
      operationId: listCustomThemes
      responses:
        '200':
          description: OK - The request succeeded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  rowCount:
                    type: integer
                    description: Total number of custom themes in the result set.
                  themes:
                    type: array
                    items:
                      $ref: '#/components/schemas/CustomTheme'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
    post:
      tags:
      - Settings
      summary: Create a custom theme
      description: Creates a new custom color theme. Requires Cloud Analytics Admin permission.
      operationId: createCustomTheme
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateCustomThemeRequest'
        required: true
      responses:
        '201':
          description: Created - Custom theme created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomTheme'
          links:
            getCustomTheme:
              operationId: getCustomTheme
              parameters:
                id: $response.body#/id
            updateCustomTheme:
              operationId: updateCustomTheme
              parameters:
                id: $response.body#/id
            deleteCustomTheme:
              operationId: deleteCustomTheme
              parameters:
                id: $response.body#/id
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
      x-codegen-request-body-name: Body
  /analytics/v1/settings/themes/{id}:
    get:
      tags:
      - Settings
      summary: Retrieve a custom theme
      description: Returns a custom theme by the specified Id.
      operationId: getCustomTheme
      parameters:
      - name: id
        in: path
        description: Custom theme ID
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK - Custom theme returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomTheme'
          links:
            updateCustomTheme:
              operationId: updateCustomTheme
              parameters:
                id: $request.path.id
            deleteCustomTheme:
              operationId: deleteCustomTheme
              parameters:
                id: $request.path.id
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
    patch:
      tags:
      - Settings
      summary: Update a custom theme
      description: Updates the custom theme specified by the Id. Requires Cloud Analytics Admin permission.
      operationId: updateCustomTheme
      parameters:
      - name: id
        in: path
        description: Custom theme ID
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateCustomThemeRequest'
        required: true
      responses:
        '200':
          description: OK - Custom theme updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomTheme'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
      x-codegen-request-body-name: Body
    delete:
      tags:
      - Settings
      summary: Delete a custom theme
      description: Deletes the custom theme specified by the Id. Requires Cloud Analytics Admin permission.
      operationId: deleteCustomTheme
      parameters:
      - name: id
        in: path
        description: Custom theme ID
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK - Custom theme deleted.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
              example: {}
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
  /analytics/v1/settings/active-theme:
    get:
      tags:
      - Settings
      summary: Get the active theme
      description: 'Returns the theme currently active for the authenticated user.

        `themeId` is the reserved sentinel `"default"` when no custom or

        preset theme is selected and the user is on the built-in default.'
      operationId: getActiveTheme
      responses:
        '200':
          description: OK - The request succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActiveTheme'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
    put:
      tags:
      - Settings
      summary: Set the active theme
      description: 'Sets the theme active for the authenticated user. Send the reserved

        sentinel `themeId: "default"` to clear the active theme and fall back

        to the built-in default. Returns the updated active theme.'
      operationId: setActiveTheme
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetActiveThemeRequest'
        required: true
      responses:
        '200':
          description: OK - Active theme updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActiveTheme'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
      x-codegen-request-body-name: Body
components:
  schemas:
    Error:
      type: object
      description: Standard error response structure.
      properties:
        error:
          type: string
          description: Detailed error message.
    ThemeColors:
      type: object
      required:
      - light
      - dark
      description: Palettes for light and dark display modes. Each palette must contain between 1 and 32 hex colors.
      properties:
        light:
          type: array
          minItems: 1
          maxItems: 32
          items:
            $ref: '#/components/schemas/HexColor'
          description: Colors used when the report is displayed in light mode.
        dark:
          type: array
          minItems: 1
          maxItems: 32
          items:
            $ref: '#/components/schemas/HexColor'
          description: Colors used when the report is displayed in dark mode.
    CreateCustomThemeRequest:
      required:
      - name
      - primaryColor
      - colors
      type: object
      description: Request body for creating a custom theme.
      properties:
        name:
          type: string
          description: The display name of the custom theme.
          maxLength: 200
        primaryColor:
          $ref: '#/components/schemas/HexColor'
        colors:
          $ref: '#/components/schemas/ThemeColors'
    UpdateCustomThemeRequest:
      type: object
      description: Request body for updating a custom theme. Only provided fields are modified.
      properties:
        name:
          type:
          - string
          - 'null'
          description: The display name of the custom theme.
          maxLength: 200
        primaryColor:
          $ref: '#/components/schemas/HexColor'
        colors:
          $ref: '#/components/schemas/ThemeColors'
    SetActiveThemeRequest:
      type: object
      required:
      - themeId
      description: Request body for setting the active custom or preset theme for the authenticated user.
      properties:
        themeId:
          type: string
          default: default
          description: 'Identifier of the theme to activate. Send the reserved sentinel

            `"default"` to clear the active theme and fall back to the built-in

            default.'
    HexColor:
      type: string
      description: A color in hex notation. Accepts `#RGB`, `#RRGGBB`, or `#RRGGBBAA`.
      pattern: ^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$
      example: '#1A73E8'
    CustomTheme:
      required:
      - id
      - name
      - primaryColor
      - colors
      type: object
      description: A custom color theme applied to Cloud Analytics reports.
      properties:
        id:
          type: string
          description: The unique identifier of the custom theme.
        name:
          type: string
          description: The display name of the custom theme.
          maxLength: 200
        primaryColor:
          $ref: '#/components/schemas/HexColor'
        colors:
          $ref: '#/components/schemas/ThemeColors'
        createTime:
          type: string
          format: date-time
          description: The creation time of the custom theme.
        updateTime:
          type: string
          format: date-time
          description: The time when the custom theme was last updated.
    ActiveTheme:
      type: object
      required:
      - themeId
      description: The theme currently active for the authenticated user.
      properties:
        themeId:
          type: string
          default: default
          description: 'Identifier of the active theme. The reserved sentinel `"default"` is

            returned when the user is using the built-in default (no custom or

            preset theme stored).'
  responses:
    '401':
      description: Unauthorized - Invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '404':
      description: Not Found - The requested resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '403':
      description: Forbidden - The client is not authorized to perform the request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    '400':
      description: Bad Request - The server cannot process the request, often due to a malformed request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      description: Use the "Bearer <API_KEY>" format or sign in for autofill
      in: header
    tenantId:
      type: apiKey
      name: X-Tenant-Id
      description: 'Customer (tenant) ID for the request. Separate from your API token: always authenticate with `Authorization: Bearer <token>` (personal or service account). See [Get Started](https://developer.doit.com/docs/start). Omit when your token is scoped to a single customer (resolved automatically). A service account can select an active direct or nested descendant of its home customer; the endpoint''s normal permissions, entitlements, and resource-ownership checks still apply. A service-account target outside that customer subtree returns `403 Forbidden`. Prefer this header over the legacy `customerContext` query parameter, which only applies to legacy API keys and is ignored by personal and service account tokens.'
      in: header
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://console.doit.com/sign-in/oauth
          tokenUrl: https://console.doit.com/api/auth/token
          scopes:
            dci: Access All Data
x-samples-languages:
- curl
- go
- node
- python
x-cli-config:
  security: oauth2
  params:
    client_id: cli
x-provenance:
  method: harvested
  publisher: DoiT
  source: https://api.doit.com/openapi.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)