> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar reglas de transmisión

> Agrega o elimina reglas del conjunto de reglas activas para el stream filtrado.



## OpenAPI

````yaml /es/openapi.json POST /2/tweets/search/stream/rules
openapi: 3.0.0
info:
  description: Endpoints disponibles en X API v2
  version: '2.157'
  title: X API v2
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
  - description: X API
    url: https://api.x.com
security: []
tags:
  - name: Account Activity
    description: Endpoints para recuperar y administrar suscripciones AAA
    externalDocs:
      description: Más información
      url: >-
        https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  - name: Bookmarks
    description: >-
      Endpoints relacionados con la recuperación y gestión de los marcadores de
      un usuario
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/bookmarks
  - name: Compliance
    description: >-
      Endpoints relacionados con garantizar que los datos de X en tus sistemas
      cumplan la normativa
    externalDocs:
      description: Más información
      url: >-
        https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction
  - name: Connections
    description: Endpoints relacionados con conexiones de streaming
    externalDocs:
      description: Más información
      url: https://developer.x.com/en/docs/x-api/connections
  - name: Direct Messages
    description: Endpoints relacionados con la recuperación y gestión de Mensajes Directos
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/direct-messages
  - name: General
    description: Endpoints diversos para la funcionalidad general de la API
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api
  - name: Lists
    description: Endpoints relacionados con la obtención y gestión de Listas
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/lists
  - name: Media
    description: Endpoints relacionados con Media
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: MediaUpload
    description: Endpoints relacionados con la carga de Media
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: News
    description: Endpoint para obtener noticias
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/news
  - name: Spaces
    description: Endpoints relacionados con la obtención y gestión de Spaces
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/spaces
  - name: Stream
    description: Endpoints relacionados con la transmisión en tiempo real
    externalDocs:
      description: Más información
      url: https://developer.x.com
  - name: Tweets
    description: Endpoints relacionados con la obtención, búsqueda y modificación de Tweets
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup
  - name: Users
    description: >-
      Endpoints relacionados con la obtención y gestión de relaciones entre
      usuarios
    externalDocs:
      description: Más información
      url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/tweets/search/stream/rules:
    post:
      tags:
        - Stream
        - Tweets
      summary: Actualizar reglas de transmisión
      description: >-
        Agrega o elimina reglas del conjunto de reglas activas para el stream
        filtrado.
      operationId: updateRules
      parameters:
        - name: dry_run
          in: query
          description: >-
            Dry Run puede utilizarse tanto con la acción de agregar como con la
            de eliminar; devuelve el resultado esperado, pero sin ejecutar
            realmente ninguna acción en el sistema (es decir, que el estado
            final siempre será el mismo que cuando se envió la solicitud). Esto
            es especialmente útil para validar cambios en las reglas.
          required: false
          schema:
            type: boolean
          style: form
        - name: delete_all
          in: query
          description: >-
            Delete All puede utilizarse para eliminar todas las reglas asociadas
            a esta App; se debe especificar sin ningún otro parámetro. Una vez
            eliminadas, las reglas no se pueden recuperar.
          required: false
          schema:
            type: boolean
          style: form
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddOrDeleteRulesRequest'
        required: true
      responses:
        '200':
          description: La solicitud se ha completado correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AddOrDeleteRulesResponse'
        default:
          description: La solicitud ha fallado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - BearerToken: []
      externalDocs:
        url: >-
          https://developer.twitter.com/en/docs/twitter-api/tweets/filtered-stream/api-reference/post-tweets-search-stream-rules
components:
  schemas:
    AddOrDeleteRulesRequest:
      oneOf:
        - $ref: '#/components/schemas/AddRulesRequest'
        - $ref: '#/components/schemas/DeleteRulesRequest'
    AddOrDeleteRulesResponse:
      type: object
      description: >-
        Respuesta a la modificación de reglas de filtrado de flujo definidas por
        el usuario.
      required:
        - meta
      properties:
        data:
          type: array
          description: >-
            Todas las reglas de filtrado de flujo definidas por el usuario que
            se han creado.
          items:
            $ref: '#/components/schemas/Rule'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
        meta:
          $ref: '#/components/schemas/RulesResponseMetadata'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Problem:
      type: object
      description: >-
        Un objeto HTTP Problem Details, tal como se define en el IETF RFC 7807
        (https://tools.ietf.org/html/rfc7807).
      required:
        - type
        - title
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          type: string
      discriminator:
        propertyName: type
        mapping:
          about:blank:
            $ref: '#/components/schemas/GenericProblem'
          https://api.twitter.com/2/problems/client-disconnected:
            $ref: '#/components/schemas/ClientDisconnectedProblem'
          https://api.twitter.com/2/problems/client-forbidden:
            $ref: '#/components/schemas/ClientForbiddenProblem'
          https://api.twitter.com/2/problems/conflict:
            $ref: '#/components/schemas/ConflictProblem'
          https://api.twitter.com/2/problems/disallowed-resource:
            $ref: '#/components/schemas/DisallowedResourceProblem'
          https://api.twitter.com/2/problems/duplicate-rules:
            $ref: '#/components/schemas/DuplicateRuleProblem'
          https://api.twitter.com/2/problems/invalid-request:
            $ref: '#/components/schemas/InvalidRequestProblem'
          https://api.twitter.com/2/problems/invalid-rules:
            $ref: '#/components/schemas/InvalidRuleProblem'
          https://api.twitter.com/2/problems/noncompliant-rules:
            $ref: '#/components/schemas/NonCompliantRulesProblem'
          https://api.twitter.com/2/problems/not-authorized-for-field:
            $ref: '#/components/schemas/FieldUnauthorizedProblem'
          https://api.twitter.com/2/problems/not-authorized-for-resource:
            $ref: '#/components/schemas/ResourceUnauthorizedProblem'
          https://api.twitter.com/2/problems/operational-disconnect:
            $ref: '#/components/schemas/OperationalDisconnectProblem'
          https://api.twitter.com/2/problems/resource-not-found:
            $ref: '#/components/schemas/ResourceNotFoundProblem'
          https://api.twitter.com/2/problems/resource-unavailable:
            $ref: '#/components/schemas/ResourceUnavailableProblem'
          https://api.twitter.com/2/problems/rule-cap:
            $ref: '#/components/schemas/RulesCapProblem'
          https://api.twitter.com/2/problems/streaming-connection:
            $ref: '#/components/schemas/ConnectionExceptionProblem'
          https://api.twitter.com/2/problems/unsupported-authentication:
            $ref: '#/components/schemas/UnsupportedAuthenticationProblem'
          https://api.twitter.com/2/problems/usage-capped:
            $ref: '#/components/schemas/UsageCapExceededProblem'
    AddRulesRequest:
      type: object
      description: >-
        Una solicitud para agregar una regla de filtrado de flujo definida por
        el usuario.
      required:
        - add
      properties:
        add:
          type: array
          items:
            $ref: '#/components/schemas/RuleNoId'
    DeleteRulesRequest:
      type: object
      description: >-
        Respuesta al eliminar reglas de filtrado del stream especificadas por el
        usuario.
      required:
        - delete
      properties:
        delete:
          type: object
          description: >-
            ID y valores de todas las reglas de filtrado del stream
            especificadas por el usuario que se han eliminado.
          properties:
            ids:
              type: array
              description: >-
                ID de todas las reglas de filtrado del stream definidas por el
                usuario que se eliminaron.
              items:
                $ref: '#/components/schemas/RuleId'
            values:
              type: array
              description: >-
                Valores de todas las reglas de filtrado del stream definidas por
                el usuario que se eliminaron.
              items:
                $ref: '#/components/schemas/RuleValue'
    Rule:
      type: object
      description: Una regla de filtrado de stream definida por el usuario.
      required:
        - value
      properties:
        id:
          $ref: '#/components/schemas/RuleId'
        tag:
          $ref: '#/components/schemas/RuleTag'
        value:
          $ref: '#/components/schemas/RuleValue'
    RulesResponseMetadata:
      type: object
      required:
        - sent
      properties:
        next_token:
          $ref: '#/components/schemas/NextToken'
        result_count:
          type: integer
          description: Número de reglas en el conjunto de resultados.
          format: int32
        sent:
          type: string
        summary:
          $ref: '#/components/schemas/RulesRequestSummary'
    GenericProblem:
      description: >-
        Un problema genérico sin información adicional aparte de la
        proporcionada por el código de estado HTTP.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientDisconnectedProblem:
      description: Tu cliente se ha desconectado.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientForbiddenProblem:
      description: >-
        Un Problem que indica que tu cliente no tiene permiso para realizar esta
        solicitud.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            reason:
              type: string
              enum:
                - official-client-forbidden
                - client-not-enrolled
            registration_url:
              type: string
              format: uri
    ConflictProblem:
      description: No puedes crear un nuevo trabajo si ya hay uno en ejecución.
      allOf:
        - $ref: '#/components/schemas/Problem'
    DisallowedResourceProblem:
      description: >-
        Un Problem que indica que el recurso solicitado infringe las normas de
        esta API.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_id
            - resource_type
            - section
          properties:
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    DuplicateRuleProblem:
      description: La regla enviada es un duplicado.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            id:
              type: string
            value:
              type: string
    InvalidRequestProblem:
      description: Un problema que indica que esta solicitud no es válida.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                properties:
                  message:
                    type: string
                  parameters:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
    InvalidRuleProblem:
      description: La regla que has enviado no es válida.
      allOf:
        - $ref: '#/components/schemas/Problem'
    NonCompliantRulesProblem:
      description: >-
        Un Problem que indica que el conjunto de reglas del usuario no cumple
        las normas.
      allOf:
        - $ref: '#/components/schemas/Problem'
    FieldUnauthorizedProblem:
      description: >-
        Un Problem que indica que no tienes permiso para ver un campo específico
        de un Tweet, un usuario, etc.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_type
            - field
            - section
          properties:
            field:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    ResourceUnauthorizedProblem:
      description: >-
        Un problema que indica que no tienes permiso para ver un Tweet, un
        usuario, etc. específicos.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - value
            - resource_id
            - resource_type
            - section
            - parameter
          properties:
            parameter:
              type: string
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
            value:
              type: string
    OperationalDisconnectProblem:
      description: Se te ha desconectado por motivos operativos.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            disconnect_type:
              type: string
              enum:
                - OperationalDisconnect
                - UpstreamOperationalDisconnect
                - ForceDisconnect
                - UpstreamUncleanDisconnect
                - SlowReader
                - InternalError
                - ClientApplicationStateDegraded
                - InvalidRules
    ResourceNotFoundProblem:
      description: Un objeto Problem que indica que un Tweet, un usuario, etc., no existe.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - value
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            value:
              type: string
              description: El valor coincidirá con el esquema definido para el campo.
    ResourceUnavailableProblem:
      description: >-
        Un problema que indica que un Tweet, un usuario, etc. específicos no
        están disponibles para ti.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
    RulesCapProblem:
      description: Has excedido el número máximo de reglas permitido.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ConnectionExceptionProblem:
      description: Un Problem que indica que algo va mal con la conexión.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            connection_issue:
              type: string
              enum:
                - TooManyConnections
                - ProvisioningSubscription
                - RuleConfigurationIssue
                - RulesInvalidIssue
    UnsupportedAuthenticationProblem:
      description: Un Problem que indica que la autenticación utilizada no es compatible.
      allOf:
        - $ref: '#/components/schemas/Problem'
    UsageCapExceededProblem:
      description: Un problema que indica que se ha superado un límite de uso.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            period:
              type: string
              enum:
                - Daily
                - Monthly
            scope:
              type: string
              enum:
                - Account
                - Product
    RuleNoId:
      type: object
      description: Una regla de filtrado de stream definida por el usuario.
      required:
        - value
      properties:
        tag:
          $ref: '#/components/schemas/RuleTag'
        value:
          $ref: '#/components/schemas/RuleValue'
    RuleId:
      type: string
      description: Identificador único de esta regla.
      pattern: ^[0-9]{1,19}$
      example: '120897978112909812'
    RuleValue:
      type: string
      description: El valor filterlang de la regla.
      example: coffee -is:retweet
    RuleTag:
      type: string
      description: Una etiqueta destinada a clasificar las reglas definidas por el usuario.
      example: Non-retweeted coffee Posts
    NextToken:
      type: string
      description: Token siguiente.
      minLength: 1
    RulesRequestSummary:
      oneOf:
        - type: object
          description: >-
            Resumen de los resultados de la incorporación de reglas de filtrado
            de stream especificadas por el usuario.
          required:
            - created
            - not_created
            - valid
            - invalid
          properties:
            created:
              type: integer
              description: >-
                Cantidad de reglas de filtrado de stream especificadas por el
                usuario que se crearon.
              format: int32
              example: 1
            invalid:
              type: integer
              description: >-
                Cantidad de reglas de filtrado de stream inválidas especificadas
                por el usuario.
              format: int32
              example: 1
            not_created:
              type: integer
              description: >-
                Cantidad de reglas de filtrado de stream especificadas por el
                usuario que no se crearon.
              format: int32
              example: 1
            valid:
              type: integer
              description: >-
                Cantidad de reglas de filtrado de stream válidas especificadas
                por el usuario.
              format: int32
              example: 1
        - type: object
          required:
            - deleted
            - not_deleted
          properties:
            deleted:
              type: integer
              description: >-
                Número de reglas de filtrado de flujo especificadas por el
                usuario que se eliminaron.
              format: int32
            not_deleted:
              type: integer
              description: >-
                Número de reglas de filtrado de flujo especificadas por el
                usuario que no se eliminaron.
              format: int32
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer

````