OpenPost App Branding API

The App Branding API from OpenPost — 4 operation(s) for app branding.

GitHub OpenAPI

Operations 4

GET /app-branding/{workspace_id} Get effective app branding and inheritance #
GET /app-branding/{workspace_id}/images/{id} Read an authorized app branding image #
PUT /app-branding/{workspace_id}/organization Set organization app branding and workspace policy #
PUT /app-branding/{workspace_id}/workspace Set workspace app branding or restore inheritance #

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/openpo-st:openpo-st-app-branding-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

openpo-st-app-branding-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: hello@openpo.st
    name: OpenPost support
    url: https://openpo.st/contact
  description: OpenPost HTTP API for workspace-scoped social publishing. Use it to inspect accounts and provider readiness, manage media and publications, schedule work, and read publishing results. Every operation still follows token scopes, workspace roles, plan limits, provider capabilities, and destination validation.
  license:
    identifier: AGPL-3.0-only
    name: AGPL-3.0-only
  termsOfService: https://openpo.st/terms
  title: OpenPost App Branding API
  version: 1.0.0
servers:
- description: OpenPost Hosted service
  url: https://app.openpo.st/api/v1
- description: The OpenPost instance serving this contract
  url: /api/v1
security:
- bearerAuth: []
- sessionCookie: []
tags:
- name: App Branding
paths:
  /app-branding/{workspace_id}:
    get:
      operationId: get-app-branding
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppBrandingSettings'
          description: OK
          headers:
            Cache-Control:
              schema:
                type: string
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Get effective app branding and inheritance
      tags:
      - App Branding
  /app-branding/{workspace_id}/images/{id}:
    get:
      operationId: get-app-branding-image
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          type: string
      - in: path
        name: id
        required: true
        schema:
          type: string
      - explode: false
        in: query
        name: organization_default
        schema:
          type: boolean
      responses:
        '200':
          content:
            image/png:
              schema:
                contentMediaType: application/octet-stream
                format: binary
                type: string
          description: PNG branding image
          headers:
            Cache-Control:
              schema:
                type: string
            Content-Type:
              schema:
                type: string
            X-Content-Type-Options:
              schema:
                type: string
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Read an authorized app branding image
      tags:
      - App Branding
  /app-branding/{workspace_id}/organization:
    put:
      operationId: update-organization-app-branding
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppBrandingUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppBrandingSettings'
          description: OK
          headers:
            Cache-Control:
              schema:
                type: string
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Set organization app branding and workspace policy
      tags:
      - App Branding
  /app-branding/{workspace_id}/workspace:
    put:
      operationId: update-workspace-app-branding
      parameters:
      - in: path
        name: workspace_id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppBrandingUpdate'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppBrandingSettings'
          description: OK
          headers:
            Cache-Control:
              schema:
                type: string
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Forbidden
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Set workspace app branding or restore inheritance
      tags:
      - App Branding
components:
  schemas:
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    AppBrandingImageInput:
      additionalProperties: false
      properties:
        content_base64:
          description: PNG, JPEG or WebP, at most 1 MiB; normalized to PNG
          maxLength: 1400000
          type: string
        id:
          description: Retain an image from this profile or copy the current organization image
          type: string
      type: object
    AppBrandingSettings:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/AppBrandingSettings.json
          format: uri
          readOnly: true
          type: string
        allow_workspace_override:
          type: boolean
        can_manage_organization:
          type: boolean
        can_manage_workspace:
          type: boolean
        effective:
          $ref: '#/components/schemas/AppBrandingProfile'
        organization_default:
          $ref: '#/components/schemas/AppBrandingProfile'
        organization_id:
          type: string
        organization_revision:
          format: int64
          type: integer
        workspace_id:
          type: string
        workspace_override:
          $ref: '#/components/schemas/AppBrandingProfile'
        workspace_revision:
          format: int64
          type: integer
      required:
      - workspace_id
      - organization_id
      - organization_default
      - organization_revision
      - workspace_revision
      - effective
      - allow_workspace_override
      - can_manage_organization
      - can_manage_workspace
      type: object
    AppBrandingImage:
      additionalProperties: false
      properties:
        id:
          type: string
        url:
          type: string
      required:
      - id
      type: object
    AppBrandingProfileInput:
      additionalProperties: false
      properties:
        dark_logo:
          $ref: '#/components/schemas/AppBrandingImageInput'
        dark_wordmark:
          $ref: '#/components/schemas/AppBrandingImageInput'
        display_name:
          maxLength: 60
          minLength: 1
          type: string
        logo:
          $ref: '#/components/schemas/AppBrandingImageInput'
        wordmark:
          $ref: '#/components/schemas/AppBrandingImageInput'
      required:
      - display_name
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    AppBrandingProfile:
      additionalProperties: false
      properties:
        dark_logo:
          $ref: '#/components/schemas/AppBrandingImage'
        dark_wordmark:
          $ref: '#/components/schemas/AppBrandingImage'
        display_name:
          maxLength: 60
          type: string
        logo:
          $ref: '#/components/schemas/AppBrandingImage'
        wordmark:
          $ref: '#/components/schemas/AppBrandingImage'
      required:
      - display_name
      type: object
    AppBrandingUpdate:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/api/v1/schemas/AppBrandingUpdate.json
          format: uri
          readOnly: true
          type: string
        allow_workspace_override:
          type: boolean
        expected_revision:
          format: int64
          minimum: 0
          type: integer
        profile:
          $ref: '#/components/schemas/AppBrandingProfileInput'
          description: Null restores OpenPost for an organization or inheritance for a workspace
      required:
      - expected_revision
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: OpenPost API token or session JWT
      scheme: bearer
      type: http
    sessionCookie:
      in: cookie
      name: openpost_session
      type: apiKey