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

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Actualizar el estado de una campaña

> Actualiza el estado de una campaña para pausarla, reanudarla, completarla o cancelarla.

Actualiza el estado de una campaña. Úsalo para pausar, reanudar, completar o cancelar una campaña.

## Transiciones de estado

* `ACTIVE` --> `PAUSED`, `COMPLETED`, `CANCELLED`
* `PAUSED` --> `ACTIVE`, `COMPLETED`, `CANCELLED`
* `COMPLETED` --> (terminal, sin más transiciones)
* `CANCELLED` --> (terminal, sin más transiciones)


## OpenAPI

````yaml openapi/es/communications-campaigns/update-campaign-status.json PATCH /campaigns/{campaign_id}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Communications Campaigns
servers:
  - url: https://api-sandbox.y.uno/v1
    description: Sandbox
  - url: https://api.y.uno/v1
    description: Production (US)
security:
  - public-api-key: []
    private-secret-key: []
paths:
  /campaigns/{campaign_id}:
    patch:
      operationId: patch_campaigns-campaign-id
      parameters:
        - in: path
          name: campaign_id
          schema:
            type: string
          required: true
          description: El identificador de la campaña (UUID).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                status:
                  type: string
                  description: Nuevo estado de la campaña.
                  enum:
                    - ACTIVE
                    - PAUSED
                    - COMPLETED
                    - CANCELLED
              required:
                - status
            examples:
              Example:
                summary: Example
                value:
                  status: PAUSED
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      name:
                        type: string
                        example: Declined Payment Recovery - Colombia
                      status:
                        type: string
                        example: PAUSED
                      updated_at:
                        type: string
                        example: '2025-07-15T10:00:00Z'
              examples:
                OK:
                  summary: OK
                  value:
                    data:
                      id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      name: Declined Payment Recovery - Colombia
                      status: PAUSED
                      updated_at: '2025-07-15T10:00:00Z'
          description: ''
        '404':
          description: No encontrado. La campaña no existe para esta cuenta.
          content:
            application/json:
              examples:
                Not Found:
                  value:
                    code: NOT_FOUND
                    messages:
                      - Not Found
              schema:
                type: object
                properties:
                  code:
                    type: string
                    example: NOT_FOUND
                  messages:
                    type: array
                    items:
                      type: string
                      example: Not Found
components:
  securitySchemes:
    public-api-key:
      type: apiKey
      in: header
      name: public-api-key
    private-secret-key:
      type: apiKey
      in: header
      name: private-secret-key

````

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