> ## 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.

# Solicitar un código de autorización de dispositivo

> Inicia un flujo de autorización de dispositivo (p. ej., para iniciar sesión en la CLI). Devuelve un código de usuario para mostrar y un código de dispositivo para consultar el estado.



## OpenAPI

````yaml /es/openapi.json post /auth/device/code
openapi: 3.0.0
info:
  title: Social media studio API
  description: >-
    La API de Social media studio te permite gestionar tu flujo de trabajo de
    redes sociales de forma programática: crear y programar publicaciones,
    organizar el contenido multimedia, consultar analíticas, gestionar tu equipo
    y mucho más.


    ## URL base


    ```

    https://api.so-me.studio

    ```


    ## Autenticación


    Todos los endpoints `/v1/*` requieren una clave de API enviada en la
    cabecera `X-API-Key`.


    ```

    X-API-Key: sk_live_xxxxxxxxxxxxxxxxxxxxxxxx

    ```


    ## Permisos (scopes)


    Una clave tiene acceso completo salvo que le asignes permisos al crearla.
    Una clave con permisos limitados solo puede llamar a los endpoints que esos
    permisos cubren; los demás endpoints devuelven `403 Forbidden`. Un endpoint
    `GET` necesita `<resource>:read`; `POST`, `PUT`, `PATCH` y `DELETE`
    necesitan `<resource>:write`, que incluye `read`. Recursos: `accounts`,
    `posts` (también borradores y aprobaciones), `media`, `analytics` (solo
    lectura), `inbox`, `ai`, `biolinks`, `teams`, `settings`, `webhooks`,
    `support`, `templates` (solo lectura), `whatsapp`. Los endpoints de claves
    de API y de espacio de trabajo bajo `/v1/settings`, y `PATCH
    /v1/settings/profile`, necesitan una clave con acceso completo. Las claves
    con permisos limitados no pueden usar el servidor MCP.


    ## Obtener tu clave de API


    1. Inicia sesión en tu espacio de trabajo en [Social media
    studio](https://so-me.studio/es)

    2. Ve a **Configuración** > pestaña **API**

    3. Haz clic en **Nueva clave de API**, ponle un nombre y copia la clave


    > La clave completa se muestra solo una vez. Guárdala de forma segura.


    ## Límites de frecuencia


    60 solicitudes por minuto y por espacio de trabajo. Si superas este límite,
    recibirás una respuesta `429 Too Many Requests`.


    ## Planes


    El acceso a la API está disponible en los planes **Standard**, **Advanced**
    y **Lifetime**.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.so-me.studio
    description: Producción
security: []
tags:
  - name: Posts
    description: Crear, gestionar, programar y publicar publicaciones en redes sociales
  - name: Accounts
    description: Gestionar las cuentas de redes sociales conectadas
  - name: Drafts
    description: Crear y gestionar borradores
  - name: Media
    description: Subir, organizar y gestionar archivos multimedia y carpetas
  - name: Analytics
    description: Analíticas de plataforma y de publicación en todas las cuentas sociales
  - name: Inbox
    description: >-
      Conversaciones de la bandeja de entrada social, respuestas y respuestas
      guardadas
  - name: AI
    description: Generación de texto e imágenes con IA
  - name: Approvals
    description: Flujo de aprobación de publicaciones para la colaboración en equipo
  - name: Teams
    description: Gestión de miembros del equipo e invitaciones
  - name: Biolinks
    description: Páginas de biolink con botones, publicaciones y temas
  - name: Settings
    description: Perfil, organización, claves de API, facturación y uso
  - name: Authentication
    description: >-
      Registro, inicio de sesión, restablecimiento de contraseña y autorización
      de dispositivo
  - name: Plans
    description: Planes de suscripción, funciones y complementos disponibles
  - name: Public Biolink
    description: >-
      Resolución de páginas de biolink públicas y seguimiento de analíticas (no
      requiere autenticación)
paths:
  /auth/device/code:
    post:
      tags:
        - Authentication
      summary: Solicitar un código de autorización de dispositivo
      description: >-
        Inicia un flujo de autorización de dispositivo (p. ej., para iniciar
        sesión en la CLI). Devuelve un código de usuario para mostrar y un
        código de dispositivo para consultar el estado.
      operationId: DeviceAuthController_requestCode
      parameters: []
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                action:
                  type: string
                  enum:
                    - connect_social
                  description: Tipo de acción opcional
                platform:
                  type: string
                  description: Nombre de la plataforma (cuando la acción es connect_social)
      responses:
        '200':
          description: Código de dispositivo emitido
          content:
            application/json:
              schema:
                type: object
                properties:
                  device_code:
                    type: string
                    description: Código de dispositivo para consultar el estado
                  user_code:
                    type: string
                    description: Código que se mostrará al usuario
                  verification_uri:
                    type: string
                    description: URL que el usuario debe visitar
                  expires_in:
                    type: number
                    description: Segundos hasta que caduca el código
                  interval:
                    type: number
                    description: Intervalo de consulta en segundos

````

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