> ## 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. # Leggere un’attività in background > Restituisce stato ed esito di un’attività in background. Se lo stato è needs_reconciliation, controlla in Emailx prima di riprovare. Permesso: `operations:read` ## OpenAPI ````yaml openapi/emailx.it.json GET /workspaces/{workspace_id}/operations/{operation_id} 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}/operations/{operation_id}: get: tags: - Attività in background summary: Leggere un’attività in background description: >- Restituisce stato ed esito di un’attività in background. Se lo stato è needs_reconciliation, controlla in Emailx prima di riprovare. Permesso: `operations:read` operationId: get_api_operation 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: operation_id in: path required: true schema: type: string pattern: ^op_[a-f0-9]{32}$ description: Identificatore della risorsa. 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/Operation' required: - data example: data: id: op_0123456789abcdef0123456789abcdef workspace_id: 123 kind: email.reply resource_type: email_conversation resource_id: 789 status: succeeded created_at: '2026-11-01T09:00:00Z' updated_at: '2026-11-01T09:00:00Z' completed_at: '2026-11-01T09:05:00Z' error_code: null cancellable: false result: reply_id: 345 provider_accepted: true delivery_verified: false '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 GET "https://app.emailx.ai/api/v1/workspaces/123/operations/op_0123456789abcdef0123456789abcdef" \ -H "Authorization: Bearer $EMAILX_API_KEY" - lang: Python source: |- import os, requests response = requests.get( "https://app.emailx.ai/api/v1/workspaces/123/operations/op_0123456789abcdef0123456789abcdef", headers={"Authorization": "Bearer " + os.environ["EMAILX_API_KEY"]}, timeout=30, ) response.raise_for_status() print(response.json()) - lang: JavaScript source: >- const response = await fetch("https://app.emailx.ai/api/v1/workspaces/123/operations/op_0123456789abcdef0123456789abcdef", { method: "GET", headers: { Authorization: `Bearer ${process.env.EMAILX_API_KEY}` }, signal: AbortSignal.timeout(30000), }); if (!response.ok) throw new Error(`Emailx: ${response.status}`); console.log(await response.json()); components: schemas: Operation: type: object properties: id: type: string pattern: ^op_[a-f0-9]{32}$ workspace_id: type: integer minimum: 1 kind: type: string enum: - linkedin.import - linkedin.activate - linkedin.resume - email.prepare - email.generate - email.activate - people.import - email.reply - linkedin.reply - warmup.control - team.invite - domains.search - linkedin.search resource_type: type: string enum: - linkedin_campaign - email_campaign - workspace - email_conversation - linkedin_conversation - email_sender - workspace_member resource_id: type: integer minimum: 1 status: type: string enum: - queued - running - awaiting_user_action - succeeded - partially_succeeded - failed - needs_reconciliation - cancelled created_at: type: string format: date-time updated_at: type: string format: date-time completed_at: type: string nullable: true format: date-time error_code: type: string nullable: true maxLength: 80 cancellable: type: boolean result: oneOf: - $ref: '#/components/schemas/ImportResult' - $ref: '#/components/schemas/LinkedinActivationResult' - $ref: '#/components/schemas/LinkedinResumeResult' - $ref: '#/components/schemas/EmailPreparationResult' - $ref: '#/components/schemas/EmailGenerationResult' - $ref: '#/components/schemas/EmailActivationResult' - $ref: '#/components/schemas/PeopleImportResult' - $ref: '#/components/schemas/ReplySendResult' - $ref: '#/components/schemas/WarmupCommandResult' - $ref: '#/components/schemas/TeamInviteResult' - $ref: '#/components/schemas/DomainAvailabilityResult' - $ref: '#/components/schemas/LinkedinLeadSearchResult' - type: object nullable: true enum: - null required: - id - workspace_id - kind - resource_type - resource_id - status - created_at - updated_at - completed_at - error_code - cancellable 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 ImportResult: type: object properties: import_job_id: type: integer minimum: 1 campaign_id: type: integer minimum: 1 status: type: string enum: - queued - running - completed - paused - failed total: type: integer minimum: 0 counts: type: object additionalProperties: type: integer minimum: 0 rows_path: type: string required: - import_job_id - campaign_id - status - total - counts - rows_path LinkedinActivationResult: type: object properties: campaign_id: type: integer minimum: 1 campaign_status: type: string enum: - active dispatch_mode: type: string enum: - native_scheduled_dispatch delivery_verified: type: boolean enum: - false required: - campaign_id - campaign_status - dispatch_mode - delivery_verified additionalProperties: false LinkedinResumeResult: type: object properties: campaign_id: type: integer minimum: 1 campaign_status: type: string enum: - active dispatch_mode: type: string enum: - native_periodic_scheduler delivery_verified: type: boolean enum: - false required: - campaign_id - campaign_status - dispatch_mode - delivery_verified additionalProperties: false EmailPreparationResult: type: object properties: workspace_id: type: integer minimum: 1 campaign_id: type: integer minimum: 1 revision: type: string pattern: ^[a-f0-9]{64}$ contact_count: type: integer minimum: 1 step_count: type: integer minimum: 1 mailbox_count: type: integer minimum: 1 task_count: type: integer minimum: 1 task_ids: type: array items: type: integer minimum: 1 status: type: string enum: - prepared scheduled: type: boolean enum: - false generation_requested: type: boolean enum: - false send_requested: type: boolean enum: - false required: - workspace_id - campaign_id - revision - contact_count - step_count - mailbox_count - task_count - task_ids - status - scheduled - generation_requested - send_requested EmailGenerationResult: type: object properties: messages: type: array maxItems: 10 items: type: object properties: task_id: type: integer minimum: 1 preview_id: type: integer minimum: 1 required: - task_id - preview_id generation_verified: type: boolean delivery_verified: type: boolean enum: - false required: - messages - generation_verified - delivery_verified EmailActivationResult: type: object properties: campaign_id: type: integer minimum: 1 campaign_status: type: string enum: - active dispatch_mode: type: string enum: - native_scheduled_dispatch delivery_verified: type: boolean enum: - false scheduled_messages: type: integer minimum: 1 maximum: 500 required: - campaign_id - campaign_status - dispatch_mode - delivery_verified - scheduled_messages additionalProperties: false PeopleImportResult: type: object properties: total_rows: type: integer minimum: 0 maximum: 1000 created_count: type: integer minimum: 0 maximum: 1000 existing_count: type: integer minimum: 0 maximum: 1000 rows_path: type: string required: - total_rows - created_count - existing_count - rows_path ReplySendResult: type: object properties: reply_id: type: integer minimum: 1 provider_accepted: type: boolean delivery_verified: type: boolean enum: - false required: - reply_id - provider_accepted - delivery_verified additionalProperties: false description: Provider acceptance is not proof of recipient delivery. WarmupCommandResult: type: object properties: sender_id: type: integer minimum: 1 warmup_active: type: boolean applied: type: array items: type: string failed: type: array items: type: string provider_confirmed: type: boolean required: - sender_id - warmup_active - applied - failed - provider_confirmed additionalProperties: false TeamInviteResult: type: object properties: member_id: type: integer minimum: 1 email: type: string invitation_sent: type: boolean reason: type: string nullable: true required: - member_id - email - invitation_sent - reason additionalProperties: false DomainAvailabilityResult: type: object properties: query: type: string success: type: boolean domains: type: array maxItems: 20 items: type: object properties: domain: type: string available: type: boolean enum: - true price: type: number nullable: true renew_price: type: number nullable: true required: - domain - available - price - renew_price checked_at: type: string format: date-time reservation: type: boolean enum: - false required: - query - success - domains - checked_at - reservation additionalProperties: false LinkedinLeadSearchResult: type: object properties: campaign_id: type: integer minimum: 1 success: type: boolean search_limited: type: boolean candidates: type: array maxItems: 25 items: type: object properties: provider_id: type: string linkedin_url: type: string nullable: true name: type: string nullable: true headline: type: string nullable: true company: type: string nullable: true location: type: string nullable: true fit_score: type: number nullable: true fit_label: type: string nullable: true required: - provider_id - linkedin_url - name - headline - company - location - fit_score - fit_label filtered_count: type: integer minimum: 0 enrolled: type: boolean enum: - false add_with: type: string enum: - create_api_prospect required: - campaign_id - success - search_limited - candidates - filtered_count - enrolled - add_with additionalProperties: false 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.