> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Rolle eines Teammitglieds aktualisieren



## OpenAPI

````yaml /de/openapi.json put /v1/teams/members/{identifier}/role
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    Die Social media studio API ermöglicht es dir, deinen Social-Media-Workflow
    programmatisch zu steuern – Beiträge erstellen und planen, Medien
    organisieren, Analysen abrufen, dein Team verwalten und mehr.


    ## Basis-URL


    ```

    https://api.so-me.studio

    ```


    ## Authentifizierung


    Alle `/v1/*`-Endpunkte erfordern einen API-Schlüssel, der im Header
    `X-API-Key` übergeben wird.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Scopes


    Ein Schlüssel hat vollen Zugriff, es sei denn, du vergibst beim Erstellen
    Scopes. Ein Schlüssel mit Scopes kann nur die Endpunkte aufrufen, die seine
    Scopes abdecken; andere Endpunkte liefern `403 Forbidden`. Ein
    `GET`-Endpunkt benötigt `<resource>:read`; `POST`, `PUT`, `PATCH` und
    `DELETE` benötigen `<resource>:write`, was `read` einschließt. Ressourcen:
    `accounts`, `posts` (auch Entwürfe und Freigaben), `media`, `analytics` (nur
    lesend), `inbox`, `ai`, `biolinks`, `teams`, `settings`, `webhooks`,
    `support`, `templates` (nur lesend), `whatsapp`. Die Endpunkte für
    API-Schlüssel und Workspaces unter `/v1/settings` sowie `PATCH
    /v1/settings/profile` erfordern einen Schlüssel mit vollem Zugriff.
    Schlüssel mit Scopes können den MCP-Server nicht nutzen.


    ## API-Schlüssel erhalten


    1. Melde dich bei deinem Workspace in [Social media
    studio](https://so-me.studio/de) an

    2. Gehe zu **Einstellungen** > Tab **API**

    3. Klicke auf **Neuer API-Schlüssel**, vergib einen Namen und kopiere den
    Schlüssel


    > Der vollständige Schlüssel wird nur einmal angezeigt. Bewahre ihn sicher
    auf.


    ## Rate Limits


    60 Anfragen pro Minute und Workspace. Wenn du dieses Limit überschreitest,
    erhältst du eine Antwort `429 Too Many Requests`.


    ## Tarife


    Der API-Zugriff ist in den Tarifen **Standard**, **Advanced** und
    **Lifetime** verfügbar.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Produktion
security: []
tags:
  - name: Posts
    description: Social-Media-Beiträge erstellen, verwalten, planen und veröffentlichen
  - name: Accounts
    description: Verbundene Social-Media-Konten verwalten
  - name: Drafts
    description: Entwürfe erstellen und verwalten
  - name: Media
    description: Mediendateien und Ordner hochladen, organisieren und verwalten
  - name: Analytics
    description: >-
      Analysen auf Plattform- und Beitragsebene über alle Social-Media-Konten
      hinweg
  - name: Inbox
    description: >-
      Unterhaltungen, Antworten und gespeicherte Antworten im
      Social-Media-Posteingang
  - name: AI
    description: KI-gestützte Text- und Bildgenerierung
  - name: Approvals
    description: Freigabe-Workflow für Beiträge zur Zusammenarbeit im Team
  - name: Teams
    description: Verwaltung von Teammitgliedern und Einladungen
  - name: Biolinks
    description: Biolink-Seiten mit Buttons, Beiträgen und Themes
  - name: Settings
    description: Profil, Organisation, API-Schlüssel, Abrechnung und Nutzung
  - name: Authentication
    description: Registrierung, Anmeldung, Passwort zurücksetzen und Geräte-Autorisierung
  - name: Plans
    description: Verfügbare Abonnement-Tarife, Funktionen und Add-ons
  - name: Public Biolink
    description: >-
      Auflösung öffentlicher Biolink-Seiten und Analyse-Tracking (keine
      Authentifizierung erforderlich)
paths:
  /v1/teams/members/{identifier}/role:
    put:
      tags:
        - Teams
      summary: Rolle eines Teammitglieds aktualisieren
      operationId: V1TeamsController_updateRole
      parameters:
        - name: identifier
          required: true
          in: path
          description: Mitglieds-UUID oder E-Mail-Adresse
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                role:
                  type: string
                  enum:
                    - owner
                    - member
                  description: >-
                    Neue Rolle. Ein Workspace kann mehrere Mitinhaber haben:
                    Wird ein Mitglied zum Inhaber befördert, wird niemand
                    herabgestuft.
                postApproval:
                  type: string
                  enum:
                    - requires_approval
                    - auto_approve
                  description: >-
                    Einstellung zur Beitragsfreigabe. Gilt nur für Mitglieder –
                    Inhaber umgehen den Freigabe-Workflow vollständig, daher
                    wird sie ignoriert, wenn die Rolle owner ist.
              required:
                - role
      responses:
        '200':
          description: Rolle des Mitglieds aktualisiert
        '400':
          description: >-
            Du kannst deine eigene Rolle nicht ändern. Ein Inhaber kann zum
            Mitglied herabgestuft werden, aber nicht, wenn er der letzte Inhaber
            des Workspace oder der Abrechnungsinhaber des Workspace ist (der
            Workspace wird über sein Abonnement abgerechnet – übertrage die
            Abrechnung zuerst auf einen anderen Inhaber).
        '404':
          description: Mitglied nicht gefunden
      security:
        - X-API-Key: []
components:
  securitySchemes:
    X-API-Key:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.