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

# Modificare i messaggi di una campagna LinkedIn attiva

> Modifica passaggi e pianificazione di una campagna LinkedIn attiva o in pausa. I messaggi inviati non cambiano e non puoi togliere passaggi in cui ci sono già persone.

Permesso: `campaigns:edit-live`

[Leggi le regole di recupero](https://docs.emailx.ai/it/api-reference/idempotency.md) prima di riprovare. Conserva chiave e corpo per la stessa operazione logica.


## OpenAPI

````yaml openapi/emailx.it.json PUT /workspaces/{workspace_id}/campaigns/linkedin/{campaign_id}/live-sequence
openapi: 3.0.3
info:
  title: Emailx API
  version: 1.0.0-beta
  description: >-
    Integrazioni Emailx per clienti e agenzie. L’accesso beta è fornito da un
    operatore. La beta v1 supporta importazioni People CSV/XLSX limitate,
    impostazioni salvate dei template email, generazione email selezionata con
    conferma esplicita dei crediti AI, approvazione del messaggio esatto, avvio
    email verificato per l’invio pianificato e risposte inbox confermate
    esplicitamente e legate al contesto salvato, se le capacità dell’host lo
    consentono. Il contesto inbox è limitato e può essere incompleto o non
    aggiornato; non viene recuperato dal provider. Importazioni, attivazione
    verificata e ripresa verificata delle campagne LinkedIn manuali in pausa
    sono flussi separati e gated. Bozze di risposta, knowledge, team, preventivi
    di infrastruttura con checkout ospitato e amministrazione di agenzia hanno
    scope dedicati. Webhook firmati comunicano l’esito delle operazioni
    durevoli. Non supporta invii immediati o addebiti diretti su carta.
servers:
  - url: https://app.emailx.ai/api/v1
    description: Applicazione Emailx · accesso da abilitare
security: []
tags:
  - name: Getting started
  - name: Workspaces
  - name: Contacts
  - name: Templates
  - name: Campaigns
  - name: Inbox
  - name: Senders
  - name: Team
  - name: Analytics
  - name: Imports
  - name: Operations
  - name: Knowledge
  - name: Infrastructure
  - name: Agency
paths:
  /workspaces/{workspace_id}/campaigns/linkedin/{campaign_id}/live-sequence:
    put:
      tags:
        - Gestire una campagna attiva
      summary: Modificare i messaggi di una campagna LinkedIn attiva
      description: >-
        Modifica passaggi e pianificazione di una campagna LinkedIn attiva o in
        pausa. I messaggi inviati non cambiano e non puoi togliere passaggi in
        cui ci sono già persone.


        Permesso: `campaigns:edit-live`
      operationId: edit_api_linkedin_live_sequence
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: integer
            minimum: 1
          description: ID account del workspace Emailx, non ID del collegamento agenzia.
        - name: campaign_id
          in: path
          required: true
          schema:
            type: integer
            minimum: 1
          description: Identificatore della risorsa.
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
            pattern: ^[A-Za-z0-9_.:/-]+$
          description: >-
            Univoco per modifica logica. Stesso percorso e corpo: replay fino a
            24 ore, se conservato.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EditLiveLinkedinSequence'
            example:
              expected_revision: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
              steps:
                - label: Intro
                  message_template: >-
                    Thank them for connecting and ask one question about their
                    operations.
                  wait_days: 0
                - label: Follow-up
                  message_template: Share one short, relevant example.
                  wait_days: 4
      responses:
        '200':
          description: Successo
          headers:
            X-Request-Id:
              schema:
                type: string
            Emailx-Api-Version:
              schema:
                type: string
            X-RateLimit-Limit:
              schema:
                type: string
            X-RateLimit-Remaining:
              schema:
                type: string
            X-RateLimit-Reset:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/LiveLinkedinSequence'
                required:
                  - data
              example:
                data:
                  campaign_id: 1
                  revision: >-
                    aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
                  steps: []
                  schedule: {}
                  prospects_rescheduled: 1
                  sent_history_changed: false
                  applies_to: future_messages
        '400':
          description: Errore della richiesta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Chiave API non valida, scaduta o revocata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Scope o permesso di modifica insufficiente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Risorsa mancante o inaccessibile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Conflitto, richiesta concorrente o esito originale incerto
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            Retry-After:
              schema:
                type: string
              description: Secondi da attendere, se presenti.
        '413':
          description: Errore della richiesta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '415':
          description: Errore della richiesta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Limite richieste raggiunto; rispettare Retry-After
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            Retry-After:
              schema:
                type: string
              description: Secondi da attendere, se presenti.
        '500':
          description: Errore della richiesta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: >-
            API disabilitata, storage richieste non disponibile o funzione non
            abilitata
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            Retry-After:
              schema:
                type: string
              description: Secondi da attendere, se presenti.
      security:
        - BearerAuth: []
      x-codeSamples:
        - lang: cURL
          source: >-
            curl -X PUT
            "https://app.emailx.ai/api/v1/workspaces/123/campaigns/linkedin/456/live-sequence"
            \
              -H "Authorization: Bearer $EMAILX_API_KEY" \
              -H "Content-Type: application/json" \
              -H "Idempotency-Key: example-operation-001" \
              --data '{"expected_revision":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","steps":[{"label":"Intro","message_template":"Thank them for connecting and ask one question about their operations.","wait_days":0},{"label":"Follow-up","message_template":"Share one short, relevant example.","wait_days":4}]}'
        - lang: Python
          source: |-
            import os, requests

            response = requests.put(
                "https://app.emailx.ai/api/v1/workspaces/123/campaigns/linkedin/456/live-sequence",
                headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"], "Idempotency-Key": "example-operation-001"},
                json={'expected_revision': 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa', 'steps': [{'label': 'Intro', 'message_template': 'Thank them for connecting and ask one question about their operations.', 'wait_days': 0}, {'label': 'Follow-up', 'message_template': 'Share one short, relevant example.', 'wait_days': 4}]},
                timeout=30,
            )
            response.raise_for_status()
            print(response.json())
        - lang: JavaScript
          source: >-
            const response = await
            fetch("https://app.emailx.ai/api/v1/workspaces/123/campaigns/linkedin/456/live-sequence",
            {
              method: "PUT",
              headers: { Authorization: `Bearer ${process.env.EMAILX_API_KEY}`, "Content-Type": "application/json", "Idempotency-Key": "example-operation-001" },
              body: JSON.stringify({"expected_revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "steps": [{"label": "Intro", "message_template": "Thank them for connecting and ask one question about their operations.", "wait_days": 0}, {"label": "Follow-up", "message_template": "Share one short, relevant example.", "wait_days": 4}]}),
              signal: AbortSignal.timeout(30000),
            });

            if (!response.ok) throw new Error(`Emailx: ${response.status}`);

            console.log(await response.json());
components:
  schemas:
    EditLiveLinkedinSequence:
      type: object
      properties:
        expected_revision:
          type: string
          pattern: ^[a-f0-9]{64}$
        steps:
          type: array
          minItems: 1
          maxItems: 5
          items:
            type: object
            properties:
              label:
                type: string
                maxLength: 200
              message_template:
                type: string
                minLength: 1
                maxLength: 8000
              wait_days:
                type: integer
                minimum: 0
                maximum: 14
                default: 3
            required:
              - message_template
            additionalProperties: false
        active_days:
          type: array
          minItems: 1
          items:
            type: string
            enum:
              - Mon
              - Tue
              - Wed
              - Thu
              - Fri
              - Sat
              - Sun
        time_start:
          type: string
          pattern: ^[0-2][0-9]:[0-5][0-9]$
        time_end:
          type: string
          pattern: ^[0-2][0-9]:[0-5][0-9]$
        user_timezone:
          type: string
          maxLength: 100
        daily_connection_limit:
          type: integer
          minimum: 1
          maximum: 30
        daily_message_limit:
          type: integer
          minimum: 1
          maximum: 100
        language:
          type: string
          maxLength: 50
      required:
        - expected_revision
        - steps
      additionalProperties: false
      description: >-
        Replaces message steps on an active or paused campaign. Steps needed by
        prospects already in the sequence cannot be removed; saved files stay
        attached by position.
    LiveLinkedinSequence:
      type: object
      properties:
        campaign_id:
          type: integer
          minimum: 1
        revision:
          type: string
          pattern: ^[a-f0-9]{64}$
        steps:
          type: array
          items:
            type: object
        schedule:
          type: object
        prospects_rescheduled:
          type: integer
          minimum: 0
        sent_history_changed:
          type: boolean
          enum:
            - false
        applies_to:
          type: string
          enum:
            - future_messages
      required:
        - campaign_id
        - revision
        - steps
        - schedule
        - prospects_rescheduled
        - sent_history_changed
        - applies_to
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            request_id:
              type: string
            details:
              type: object
              additionalProperties: true
          required:
            - code
            - message
            - request_id
      required:
        - error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chiave ex_test_ o ex_live_ emessa da un operatore Emailx. Non usare
        credenziali provider o cookie di sessione.

````

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