La búsqueda solo se carga cuando la usas. Explora todas las categorías a continuación.

Cuentas y espacios de trabajo

Listar cuentas conectadas

Lista las cuentas sociales (Instagram, Threads, Facebook, YouTube) conectadas a un espacio de trabajo, con datos del estado de conexión y las capacidades. Usa sus ids como social_account_id al programar o comentar. Proporciona workspace_id: una solicitud sin él se rechaza cuando se exige un destino explícito.

POST /identity-api/user/social-accounts/list

Contrato revisado: · sha256:563d2d581da0ad29

Descripción general

Lista las cuentas sociales (Instagram, Threads, Facebook, YouTube) conectadas a un espacio de trabajo, con datos del estado de conexión y las capacidades. Usa sus ids como social_account_id al programar o comentar. Proporciona workspace_id: una solicitud sin él se rechaza cuando se exige un destino explícito.

Una respuesta HTTP exitosa puede indicar aceptación, no finalización. Para trabajo en segundo plano, guarda el ID devuelto y consulta la misma operación hasta que termine. Una publicación programada o aceptada solo está publicada cuando la plataforma lo confirma; un tiempo de espera agotado en el cliente no determina el resultado.

Autenticación y permisos

Clases de credenciales aceptadas
user_session, delegated_oauth, personal_access_token
Capacidad delegada
agent:operate
Rol mínimo del espacio de trabajo
Este contrato no exige un rol mínimo de espacio de trabajo; siguen aplicándose las comprobaciones de propiedad y permisos.
Alcance del acceso
Recursos a los que este usuario está autorizado a acceder
Se requiere consentimiento para todos los espacios de trabajo
No
Cambia el estado
No
Cuando la operación se completa
synchronous_http_response

Un token solo puede usar los derechos de su propietario. Cada solicitud comprueba pertenencia al espacio, propiedad del recurso, espacios elegidos y capacidades concedidas. Los perfiles core y full cambian qué herramientas se muestran; no conceden acceso.

Campos de solicitud

Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.

Campos de solicitud
Campo / ramaTipo / obligatorioRestricciones
$objectObligatorio en el objeto principal
  • additionalProperties: false
workspace_idstringOpcional / elemento
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
include_authorization_grantbooleanOpcional / elemento—
JSON Schema completo
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "include_authorization_grant": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

Respuesta y finalización

Estados HTTP de éxito: 200. Cuando la operación se completa: synchronous_http_response.

Una respuesta HTTP exitosa puede indicar aceptación, no finalización. Para trabajo en segundo plano, guarda el ID devuelto y consulta la misma operación hasta que termine. Una publicación programada o aceptada solo está publicada cuando la plataforma lo confirma; un tiempo de espera agotado en el cliente no determina el resultado.

Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.

Respuesta y finalización
Campo / ramaTipo / obligatorioRestricciones
$objectObligatorio en el objeto principal—
accountsarrayObligatorio en el objeto principal—
accounts[]objectOpcional / elemento—
accounts[].idstringObligatorio en el objeto principal
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
accounts[].platformstringObligatorio en el objeto principal
  • enum: ["instagram","threads","facebook","tiktok","linkedin","youtube","x"]
accounts[].handlestring | nullObligatorio en el objeto principal—
accounts[].handleanyOf 1stringObligatorio en el objeto principal—
accounts[].handleanyOf 2nullObligatorio en el objeto principal—
accounts[].statusstringObligatorio en el objeto principal
  • enum: ["valid","expiring_soon","expired","disconnected"]
accounts[].expires_atstring | nullObligatorio en el objeto principal—
accounts[].expires_atanyOf 1stringObligatorio en el objeto principal—
accounts[].expires_atanyOf 2nullObligatorio en el objeto principal—
accounts[].created_atstringObligatorio en el objeto principal—
accounts[].avatar_urlstring | nullOpcional / elemento—
accounts[].avatar_urlanyOf 1stringOpcional / elemento—
accounts[].avatar_urlanyOf 2nullOpcional / elemento—
accounts[].follower_countinteger | nullOpcional / elemento—
accounts[].follower_countanyOf 1integerOpcional / elemento
  • minimum: 0
  • maximum: 9007199254740991
accounts[].follower_countanyOf 2nullOpcional / elemento—
accounts[].post_countinteger | nullOpcional / elemento—
accounts[].post_countanyOf 1integerOpcional / elemento
  • minimum: 0
  • maximum: 9007199254740991
accounts[].post_countanyOf 2nullOpcional / elemento—
accounts[].auto_sync_enabledbooleanOpcional / elemento—
accounts[].last_synced_atstring | nullOpcional / elemento—
accounts[].last_synced_atanyOf 1stringOpcional / elemento—
accounts[].last_synced_atanyOf 2nullOpcional / elemento—
accounts[].workspace_idstring | nullOpcional / elemento—
accounts[].workspace_idanyOf 1stringOpcional / elemento
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
accounts[].workspace_idanyOf 2nullOpcional / elemento—
accounts[].platform_user_idstring | nullOpcional / elemento—
accounts[].platform_user_idanyOf 1stringOpcional / elemento
  • minLength: 1
accounts[].platform_user_idanyOf 2nullOpcional / elemento—
accounts[].instagram_login_modestring | nullOpcional / elemento—
accounts[].instagram_login_modeanyOf 1stringOpcional / elemento
  • enum: ["instagram_login","facebook_login"]
accounts[].instagram_login_modeanyOf 2nullOpcional / elemento—
accounts[].facebook_page_idstring | nullOpcional / elemento—
accounts[].facebook_page_idanyOf 1stringOpcional / elemento
  • minLength: 1
accounts[].facebook_page_idanyOf 2nullOpcional / elemento—
accounts[].blocked_untilstring | nullOpcional / elemento—
accounts[].blocked_untilanyOf 1stringOpcional / elemento—
accounts[].blocked_untilanyOf 2nullOpcional / elemento—
accounts[].block_reasonstring | nullOpcional / elemento—
accounts[].block_reasonanyOf 1stringOpcional / elemento
  • enum: ["transient","account_block","auth_invalid","permanent"]
accounts[].block_reasonanyOf 2nullOpcional / elemento—
accounts[].block_subcodeinteger | nullOpcional / elemento—
accounts[].block_subcodeanyOf 1integerOpcional / elemento
  • minimum: -9007199254740991
  • maximum: 9007199254740991
accounts[].block_subcodeanyOf 2nullOpcional / elemento—
accounts[].block_countintegerOpcional / elemento
  • minimum: 0
  • maximum: 9007199254740991
accounts[].last_block_atstring | nullOpcional / elemento—
accounts[].last_block_atanyOf 1stringOpcional / elemento—
accounts[].last_block_atanyOf 2nullOpcional / elemento—
accounts[].health_statestringObligatorio en el objeto principal
  • enum: ["ready","action_required","temporarily_unavailable","publishing_restricted","disconnected","unknown"]
accounts[].health_messagestringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 500
accounts[].health_observed_atstring | nullObligatorio en el objeto principal—
accounts[].health_observed_atanyOf 1stringObligatorio en el objeto principal—
accounts[].health_observed_atanyOf 2nullObligatorio en el objeto principal—
accounts[].authorization_grantobjectOpcional / elemento—
accounts[].authorization_grantoneOf 1objectOpcional / elemento—
accounts[].authorization_grant.granted_permissionsoneOf 1arrayObligatorio en el objeto principal—
accounts[].authorization_grant.granted_permissions[]oneOf 1stringOpcional / elemento
  • minLength: 1
accounts[].authorization_grant.inventory_sourceoneOf 1stringObligatorio en el objeto principal
  • enum: ["oauth_token_response","provider_token_debug","provider_permissions_endpoint"]
accounts[].authorization_grant.inventory_exactoneOf 1booleanObligatorio en el objeto principal
  • const: true
accounts[].authorization_grant.observed_atoneOf 1stringObligatorio en el objeto principal
  • minLength: 1
accounts[].authorization_grant.provider_api_versiononeOf 1stringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 40
accounts[].authorization_grant.oauth_provideroneOf 1stringObligatorio en el objeto principal
  • enum: ["instagram","threads","meta","google"]
accounts[].authorization_grant.oauth_subject_idoneOf 1stringObligatorio en el objeto principal
  • minLength: 1
accounts[].authorization_grantoneOf 2objectOpcional / elemento—
accounts[].authorization_grant.granted_permissionsoneOf 2arrayObligatorio en el objeto principal
  • minItems: 0
  • maxItems: 0
accounts[].authorization_grant.granted_permissions[]oneOf 2any JSON valueOpcional / elemento—
accounts[].authorization_grant.inventory_sourceoneOf 2stringObligatorio en el objeto principal
  • const: "unavailable"
accounts[].authorization_grant.inventory_exactoneOf 2booleanObligatorio en el objeto principal
  • const: false
accounts[].authorization_grant.observed_atoneOf 2nullObligatorio en el objeto principal—
accounts[].authorization_grant.provider_api_versiononeOf 2nullObligatorio en el objeto principal—
accounts[].authorization_grant.oauth_provideroneOf 2string | nullObligatorio en el objeto principal—
accounts[].authorization_grant.oauth_provideroneOf 2 / anyOf 1stringObligatorio en el objeto principal
  • enum: ["instagram","threads","meta","google"]
accounts[].authorization_grant.oauth_provideroneOf 2 / anyOf 2nullObligatorio en el objeto principal—
accounts[].authorization_grant.oauth_subject_idoneOf 2string | nullObligatorio en el objeto principal—
accounts[].authorization_grant.oauth_subject_idoneOf 2 / anyOf 1stringObligatorio en el objeto principal
  • minLength: 1
accounts[].authorization_grant.oauth_subject_idoneOf 2 / anyOf 2nullObligatorio en el objeto principal—
accounts[].current_capability_snapshot_idstring | nullObligatorio en el objeto principal—
accounts[].current_capability_snapshot_idanyOf 1stringObligatorio en el objeto principal
  • format: "uuid"
  • pattern: "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
accounts[].current_capability_snapshot_idanyOf 2nullObligatorio en el objeto principal—
accounts[].capability_factsarrayObligatorio en el objeto principal—
accounts[].capability_facts[]objectOpcional / elemento—
accounts[].capability_facts[].capabilitystringObligatorio en el objeto principal
  • enum: ["can_publish_text","can_publish_image","can_publish_video","can_publish_reel","can_publish_carousel","can_publish_first_comment","can_publish_topic_tag","can_publish_link","can_upload_video","can_set_title","can_set_description","can_set_thumbnail","can_set_privacy_status","can_publish_story","can_invite_collaborators","can_tag_products","can_publish_trial_reel","can_publish_partnership","can_delete_media","can_publish_reply","can_quote_post","can_repost","can_publish_poll","can_publish_gif","can_publish_text_attachment","can_publish_ghost_post","can_tag_location","can_crossshare_to_instagram","can_auto_publish_text","can_delete_post","can_publish_multi_image","can_target_post","can_backdate_post","can_manage_native_schedule","can_update_video","can_delete_video","can_set_brand_partner"]
accounts[].capability_facts[].observed_allowedboolean | nullObligatorio en el objeto principal—
accounts[].capability_facts[].observed_allowedanyOf 1booleanObligatorio en el objeto principal—
accounts[].capability_facts[].observed_allowedanyOf 2nullObligatorio en el objeto principal—
accounts[].capability_facts[].availabilitystringObligatorio en el objeto principal
  • enum: ["available","unavailable","unknown","documented_ambiguous"]
accounts[].capability_facts[].reason_codestringObligatorio en el objeto principal
  • pattern: "^[a-z0-9_]+$"
accounts[].capability_facts[].observed_atstringObligatorio en el objeto principal—
accounts[].capability_facts[].valid_untilstringObligatorio en el objeto principal—
accounts[].capability_facts[].provider_api_versionstringObligatorio en el objeto principal
  • minLength: 1
  • maxLength: 40
accounts[].capability_facts[].required_permissionsarrayObligatorio en el objeto principal—
accounts[].capability_facts[].required_permissions[]stringOpcional / elemento
  • minLength: 1
accounts[].capability_facts[].granted_permissionsarrayObligatorio en el objeto principal—
accounts[].capability_facts[].granted_permissions[]stringOpcional / elemento
  • minLength: 1
accounts[].capability_facts[].account_eligibilityobjectObligatorio en el objeto principal
  • additionalProperties: {}
accounts[].capability_facts[].account_eligibility.*any JSON valueOpcional / elemento—
JSON Schema completo
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "accounts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
          },
          "platform": {
            "type": "string",
            "enum": [
              "instagram",
              "threads",
              "facebook",
              "tiktok",
              "linkedin",
              "youtube",
              "x"
            ]
          },
          "handle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "valid",
              "expiring_soon",
              "expired",
              "disconnected"
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "type": "string"
          },
          "avatar_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "follower_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "post_count": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "auto_sync_enabled": {
            "type": "boolean"
          },
          "last_synced_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "workspace_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "platform_user_id": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "instagram_login_mode": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "instagram_login",
                  "facebook_login"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "facebook_page_id": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "blocked_until": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "block_reason": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "transient",
                  "account_block",
                  "auth_invalid",
                  "permanent"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "block_subcode": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ]
          },
          "block_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 9007199254740991
          },
          "last_block_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "health_state": {
            "type": "string",
            "enum": [
              "ready",
              "action_required",
              "temporarily_unavailable",
              "publishing_restricted",
              "disconnected",
              "unknown"
            ]
          },
          "health_message": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "health_observed_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "authorization_grant": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "granted_permissions": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1
                    }
                  },
                  "inventory_source": {
                    "type": "string",
                    "enum": [
                      "oauth_token_response",
                      "provider_token_debug",
                      "provider_permissions_endpoint"
                    ]
                  },
                  "inventory_exact": {
                    "type": "boolean",
                    "const": true
                  },
                  "observed_at": {
                    "type": "string",
                    "minLength": 1
                  },
                  "provider_api_version": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 40
                  },
                  "oauth_provider": {
                    "type": "string",
                    "enum": [
                      "instagram",
                      "threads",
                      "meta",
                      "google"
                    ]
                  },
                  "oauth_subject_id": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "required": [
                  "granted_permissions",
                  "inventory_source",
                  "inventory_exact",
                  "observed_at",
                  "provider_api_version",
                  "oauth_provider",
                  "oauth_subject_id"
                ]
              },
              {
                "type": "object",
                "properties": {
                  "granted_permissions": {
                    "minItems": 0,
                    "maxItems": 0,
                    "type": "array",
                    "items": {
                      "not": {}
                    }
                  },
                  "inventory_source": {
                    "type": "string",
                    "const": "unavailable"
                  },
                  "inventory_exact": {
                    "type": "boolean",
                    "const": false
                  },
                  "observed_at": {
                    "type": "null"
                  },
                  "provider_api_version": {
                    "type": "null"
                  },
                  "oauth_provider": {
                    "anyOf": [
                      {
                        "type": "string",
                        "enum": [
                          "instagram",
                          "threads",
                          "meta",
                          "google"
                        ]
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "oauth_subject_id": {
                    "anyOf": [
                      {
                        "type": "string",
                        "minLength": 1
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "granted_permissions",
                  "inventory_source",
                  "inventory_exact",
                  "observed_at",
                  "provider_api_version",
                  "oauth_provider",
                  "oauth_subject_id"
                ]
              }
            ]
          },
          "current_capability_snapshot_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid",
                "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
              },
              {
                "type": "null"
              }
            ]
          },
          "capability_facts": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "capability": {
                  "type": "string",
                  "enum": [
                    "can_publish_text",
                    "can_publish_image",
                    "can_publish_video",
                    "can_publish_reel",
                    "can_publish_carousel",
                    "can_publish_first_comment",
                    "can_publish_topic_tag",
                    "can_publish_link",
                    "can_upload_video",
                    "can_set_title",
                    "can_set_description",
                    "can_set_thumbnail",
                    "can_set_privacy_status",
                    "can_publish_story",
                    "can_invite_collaborators",
                    "can_tag_products",
                    "can_publish_trial_reel",
                    "can_publish_partnership",
                    "can_delete_media",
                    "can_publish_reply",
                    "can_quote_post",
                    "can_repost",
                    "can_publish_poll",
                    "can_publish_gif",
                    "can_publish_text_attachment",
                    "can_publish_ghost_post",
                    "can_tag_location",
                    "can_crossshare_to_instagram",
                    "can_auto_publish_text",
                    "can_delete_post",
                    "can_publish_multi_image",
                    "can_target_post",
                    "can_backdate_post",
                    "can_manage_native_schedule",
                    "can_update_video",
                    "can_delete_video",
                    "can_set_brand_partner"
                  ]
                },
                "observed_allowed": {
                  "anyOf": [
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "availability": {
                  "type": "string",
                  "enum": [
                    "available",
                    "unavailable",
                    "unknown",
                    "documented_ambiguous"
                  ]
                },
                "reason_code": {
                  "type": "string",
                  "pattern": "^[a-z0-9_]+$"
                },
                "observed_at": {
                  "type": "string"
                },
                "valid_until": {
                  "type": "string"
                },
                "provider_api_version": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 40
                },
                "required_permissions": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "granted_permissions": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "account_eligibility": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                }
              },
              "required": [
                "capability",
                "observed_allowed",
                "availability",
                "reason_code",
                "observed_at",
                "valid_until",
                "provider_api_version",
                "required_permissions",
                "granted_permissions",
                "account_eligibility"
              ]
            }
          }
        },
        "required": [
          "id",
          "platform",
          "handle",
          "status",
          "expires_at",
          "created_at",
          "health_state",
          "health_message",
          "health_observed_at",
          "current_capability_snapshot_id",
          "capability_facts"
        ]
      }
    }
  },
  "required": [
    "accounts"
  ]
}

Errores y reintentos seguros

Comprueba el estado HTTP y el cuerpo de respuesta. Un error de validación 400 puede contener un ZodError; los errores del controlador usan los campos error, message y code. Conserva request_id o x-request-id para el diagnóstico, sin credenciales. Corrige los errores de acceso 401/403 antes de reintentar y respeta Retry-After para 429. Si una escritura es incierta o devuelve 5xx, consulta primero el resultado existente. Reutiliza una clave de idempotencia solo donde se admita; el comportamiento de reintento varía por operación y no garantiza una entrega exactamente una vez.

Guía de solución de problemas

Ejemplos

Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes API.

Establece SOSOAPI_ACCESS_TOKEN en tu servidor con una credencial aceptada por esta operación y mantenla fuera del código del navegador. Para un agente, usa sosoapi auth login para iniciar sesión en el navegador y deja a la CLI renovar sus credenciales.

request.json

{}

cURL

curl --request POST \
  "https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/user/social-accounts/list" \
  -H "Authorization: Bearer $SOSOAPI_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

JavaScript

// Server-side JavaScript. Do not print tokens or credential-bearing responses.
const token = process.env.SOSOAPI_ACCESS_TOKEN;
if (!token) throw new Error("Set an accepted credential for this operation");
const response = await fetch("https://gqeshlawtcexsapabaui.supabase.co/functions/v1/identity-api/user/social-accounts/list", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: "Bearer " + token },
  body: JSON.stringify({})
});
const result = await response.json();
// Check response.ok, the operation-specific body and completion state before continuing.

CLI

npx sosoapi api post /identity-api/user/social-accounts/list < request.json

Ejemplo de respuesta sintética

{
  "accounts": []
}

MCP: sosoapi_list_connected_accounts