Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.
Los siguientes campos no pueden modificarse después de la creación. Incluirlos en un PATCH devuelve 400 IMMUTABLE_FIELD e identifica el campo en conflicto en la llave field:
agent_id
integration_id
integration_type
cycles.enabled
cycles.mode
Las campañas finalizadas son de solo lectura y devuelven 409 CAMPAIGN_FINISHED ante cualquier PATCH.
Los campos de ciclo solo pueden actualizarse en campañas con ciclos habilitados (400 CYCLES_NOT_ENABLED en otro caso). schedule, schedule_start_date y schedule_end_date solo son válidos cuando cycles.mode es scheduled (400 SCHEDULED_MODE_ONLY en otro caso).
Partial update. Any field may be omitted. Immutable fields (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) cannot be included.
Single Campaign detail with nested agent, integration and cycles config. The analytics field is included only when a snapshot is available for the campaign.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Altur","colors":{"primary":"#0066FF","light":"#0066FF","dark":"#0066FF"},"logo":{"light":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/light.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=20f8f677ccc5d294c37dc46192e3ea74","dark":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/dark.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=bba6b7c061d8e259a4fd8c730fc5f443"},"favicon":"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/favicon.png?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=f0a4001cb667a302a1c7450a03343056","background":{"decoration":"grid","color":{"light":"#FFFFFF","dark":"#0D1117"}},"navbar":{"links":[{"href":"https://altur.io/blog","label":"Blog"}],"primary":{"type":"button","label":"Open App","href":"https://app.altur.io"}},"footer":{"socials":{"github":"https://github.com/alturio","linkedin":"https://www.linkedin.com/company/alturio"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"en/documentation/introduction"},{"language":"es","href":"es/documentation/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"altur","hasAudioNarration":false,"actualSubdomain":"altur","customDomains":["docs.altur.io"],"gitSource":{"type":"github","owner":"alturio","repo":"altur-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acadd7e230feb32d3d87044","collectionId":"08760b2e-5011-4e9f-bbdb-a1a2190a0ad4","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acadd7e230feb32d3d87044"},"entitlements":{},"buildId":"6acadd7e230feb32d3d87044","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"en","tag":"API Reference","count":28},{"language":"es","tag":"Referencia de API","count":28},{"language":"en","tag":"API Endpoints","count":20},{"language":"es","tag":"Endpoints de API","count":20},{"language":"en","tag":"Campaigns","count":12},{"language":"es","tag":"Campañas","count":12},{"language":"en","tag":"Webhooks","count":6},{"language":"es","tag":"Webhooks","count":6},{"language":"en","tag":"Webhook Events","count":5},{"language":"en","tag":"Documentation","count":5},{"language":"es","tag":"Eventos de Webhook","count":5},{"language":"es","tag":"Documentación","count":5},{"language":"en","tag":"EndUsers","count":4},{"language":"es","tag":"EndUsers","count":4},{"language":"en","tag":"Calls","count":3},{"language":"es","tag":"Introducción","count":3},{"language":"es","tag":"Llamadas","count":3},{"language":"en","tag":"Getting Started","count":2},{"language":"en","tag":"Messages","count":2},{"language":"es","tag":"Mensajes","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"es/api-reference/campaigns/update","slug":"/es/api-reference/campaigns/update","pageMetadata":{"title":"Actualizar Campaña","openapi":"PATCH /campaigns/{id}","description":"Actualización parcial de una Campaña. Los campos inmutables (`agent_id`, `integration_id`, `integration_type`, `cycles.enabled`, `cycles.mode`) no se pueden modificar y devuelven `IMMUTABLE_FIELD`. Las campañas finalizadas son de solo lectura.","href":"/es/api-reference/campaigns/update"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Actualización parcial de una Campaña. Los campos inmutables (\", _jsx(_components.code, {\n children: \"agent_id\"\n }), \", \", _jsx(_components.code, {\n children: \"integration_id\"\n }), \", \", _jsx(_components.code, {\n children: \"integration_type\"\n }), \", \", _jsx(_components.code, {\n children: \"cycles.enabled\"\n }), \", \", _jsx(_components.code, {\n children: \"cycles.mode\"\n }), \") no se pueden modificar y devuelven \", _jsx(_components.code, {\n children: \"IMMUTABLE_FIELD\"\n }), \". Las campañas finalizadas son de solo lectura.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Info}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Límite de Tasa:`}),` 12 solicitudes por segundo`]})}),`\n`,_jsx(Heading,{level:`2`,id:`campos-inmutables`,children:`Campos Inmutables`}),`\n`,_jsxs(_components.p,{children:[`Los siguientes campos no pueden modificarse después de la creación. Incluirlos en un PATCH devuelve `,_jsx(_components.code,{children:`400 IMMUTABLE_FIELD`}),` e identifica el campo en conflicto en la llave `,_jsx(_components.code,{children:`field`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`agent_id`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`integration_id`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`integration_type`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cycles.enabled`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`cycles.mode`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Las campañas finalizadas son de solo lectura y devuelven `,_jsx(_components.code,{children:`409 CAMPAIGN_FINISHED`}),` ante cualquier PATCH.`]}),`\n`,_jsx(Heading,{level:`2`,id:`actualizaciones-de-ciclo`,children:`Actualizaciones de Ciclo`}),`\n`,_jsxs(_components.p,{children:[`Los campos de ciclo solo pueden actualizarse en campañas con ciclos habilitados (`,_jsx(_components.code,{children:`400 CYCLES_NOT_ENABLED`}),` en otro caso). `,_jsx(_components.code,{children:`schedule`}),`, `,_jsx(_components.code,{children:`schedule_start_date`}),` y `,_jsx(_components.code,{children:`schedule_end_date`}),` solo son válidos cuando `,_jsx(_components.code,{children:`cycles.mode`}),` es `,_jsx(_components.code,{children:`scheduled`}),` (`,_jsx(_components.code,{children:`400 SCHEDULED_MODE_ONLY`}),` en otro caso).`]}),`\n`,_jsx(Heading,{level:`2`,id:`ejemplos`,children:`Ejemplos`}),`\n`,_jsx(Heading,{level:`3`,id:`renombrar-campaña-y-reducir-reintentos`,children:`Renombrar campaña y reducir reintentos`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Reactivación Q2 - ola 2\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"retries\": 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.patch(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Reactivación Q2 - ola 2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"retries\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`response.raise_for_status()`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`8`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"PATCH\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`name:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Reactivación Q2 - ola 2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`retries:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`3`,id:`cambiar-el-cooldown-del-ciclo`,children:`Cambiar el cooldown del ciclo`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` PATCH`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cycles\": { \"cooldown_minutes\": 60 }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`5`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`requests.patch(`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cycles\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cooldown_minutes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`60`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).raise_for_status()`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`JavaScript`,numberOfLines:`8`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.altur.io/api/v1.0/campaigns/1234\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"PATCH\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Authorization:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"api-key YOUR_API_SECRET_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`cycles:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`cooldown_minutes:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 60`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Actualizar Campaña","openapi":"PATCH /campaigns/{id}","description":"Actualización parcial de una Campaña. Los campos inmutables (`agent_id`, `integration_id`, `integration_type`, `cycles.enabled`, `cycles.mode`) no se pueden modificar y devuelven `IMMUTABLE_FIELD`. Las campañas finalizadas son de solo lectura.","href":"/es/api-reference/campaigns/update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Campos Inmutables","slug":"campos-inmutables","depth":2,"children":[]},{"title":"Actualizaciones de Ciclo","slug":"actualizaciones-de-ciclo","depth":2,"children":[]},{"title":"Ejemplos","slug":"ejemplos","depth":2,"children":[{"title":"Renombrar campaña y reducir reintentos","slug":"renombrar-campaña-y-reducir-reintentos","depth":3,"children":[]},{"title":"Cambiar el cooldown del ciclo","slug":"cambiar-el-cooldown-del-ciclo","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Actualización parcial de una Campaña. Los campos inmutables (`agent_id`, `integration_id`, `integration_type`, `cycles.enabled`, `cycles.mode`) no se pueden modificar y devuelven `IMMUTABLE_FIELD`. Las campañas finalizadas son de solo lectura.","parameters":["b0ef0f16-14f3-485f-b17a-9fb106e5a93e"],"requestBody":"19f74f8b-1cec-48f1-b54d-f75b26d8f20d","responses":{"200":"cb68f979-f780-41be-a0fc-06462d885d7e","400":"015e4506-cabc-412f-954b-a9b1333a4e93","401":"53b03673-590b-4eb7-88e1-a5e95a674e66","404":"45605ab3-90d4-4d4b-84ff-34a0e648109e","409":"435c8d88-6bda-4728-8ddf-46250aa7d01b"},"method":"patch","type":"path","servers":["c8d15ecb-4ef9-4af2-8da9-65bf53121690"],"security":["2abef093-c110-4cfb-9665-f370af43e5e8"],"path":"/campaigns/{id}","baseUrlOptions":["https://api.altur.io/api/v1.0"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"b0ef0f16-14f3-485f-b17a-9fb106e5a93e":{"name":"id","in":"path","description":"The identifier of the Campaign","schema":{"type":"integer","isRequired":true,"description":"The identifier of the Campaign","uniqueKey":"","typeLabel":"integer"},"required":true}},"requestBody":{"description":"Partial Campaign update","required":true,"content":{"application/json":{"schema":{"type":"object","description":"Partial update. Any field may be omitted. Immutable fields (`agent_id`, `integration_id`, `integration_type`, `cycles.enabled`, `cycles.mode`) cannot be included.","properties":{"name":{"type":"string","maxLength":255,"uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"timezone":{"type":"string","uniqueKey":"timezone","typeLabel":"string"},"retries":{"type":"integer","minimum":0,"maximum":5,"uniqueKey":"retries","typeLabel":"integer"},"message_limit":{"type":"integer","minimum":1,"maximum":10000,"uniqueKey":"message_limit","typeLabel":"integer"},"scheduling":{"type":"object","properties":{"mon":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.mon.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.mon.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.mon.active","typeLabel":"boolean"}},"description":"Monday","uniqueKey":"scheduling.mon","typeLabel":"object"},"tue":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.tue.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.tue.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.tue.active","typeLabel":"boolean"}},"description":"Tuesday","uniqueKey":"scheduling.tue","typeLabel":"object"},"wed":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.wed.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.wed.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.wed.active","typeLabel":"boolean"}},"description":"Wednesday","uniqueKey":"scheduling.wed","typeLabel":"object"},"thu":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.thu.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.thu.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.thu.active","typeLabel":"boolean"}},"description":"Thursday","uniqueKey":"scheduling.thu","typeLabel":"object"},"fri":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.fri.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.fri.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.fri.active","typeLabel":"boolean"}},"description":"Friday","uniqueKey":"scheduling.fri","typeLabel":"object"},"sat":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.sat.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.sat.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.sat.active","typeLabel":"boolean"}},"description":"Saturday","uniqueKey":"scheduling.sat","typeLabel":"object"},"sun":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.sun.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"scheduling.sun.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"scheduling.sun.active","typeLabel":"boolean"}},"description":"Sunday","uniqueKey":"scheduling.sun","typeLabel":"object"}},"uniqueKey":"scheduling","typeLabel":"object"},"first_message":{"type":"string","uniqueKey":"first_message","typeLabel":"string"},"template":{"type":"string","uniqueKey":"template","typeLabel":"string"},"template_alt":{"type":"string","uniqueKey":"template_alt","typeLabel":"string"},"cycles":{"type":"object","description":"Cycles configuration block. Phone-call campaigns only.","properties":{"enabled":{"type":"boolean","description":"Whether cycles are enabled. Immutable after creation.","uniqueKey":"cycles.enabled","typeLabel":"boolean"},"mode":{"type":"string","enum":["cooldown","scheduled"],"description":"Cycle mode. Immutable after creation.","uniqueKey":"cycles.mode","typeLabel":"enum\u003cstring>"},"max_iterations":{"type":"integer","minimum":2,"maximum":12,"uniqueKey":"cycles.max_iterations","typeLabel":"integer"},"cooldown_minutes":{"type":"integer","minimum":0,"maximum":1440,"uniqueKey":"cycles.cooldown_minutes","typeLabel":"integer"},"filter_statuses":{"type":"array","items":{"type":"string","uniqueKey":"cycles.filter_statuses.items.[INDEX]","typeLabel":"string"},"description":"Contact statuses excluded from the next iteration.","uniqueKey":"cycles.filter_statuses","typeLabel":"string[]"},"filter_tags":{"type":"array","items":{"type":"string","uniqueKey":"cycles.filter_tags.items.[INDEX]","typeLabel":"string"},"description":"Thread tag ids whose contacts are excluded from the next iteration. Input-only; not returned on the detail response.","uniqueKey":"cycles.filter_tags","typeLabel":"string[]"},"schedule":{"type":"object","properties":{"mon":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.mon.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.mon.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.mon.active","typeLabel":"boolean"}},"description":"Monday","uniqueKey":"cycles.schedule.mon","typeLabel":"object"},"tue":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.tue.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.tue.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.tue.active","typeLabel":"boolean"}},"description":"Tuesday","uniqueKey":"cycles.schedule.tue","typeLabel":"object"},"wed":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.wed.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.wed.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.wed.active","typeLabel":"boolean"}},"description":"Wednesday","uniqueKey":"cycles.schedule.wed","typeLabel":"object"},"thu":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.thu.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.thu.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.thu.active","typeLabel":"boolean"}},"description":"Thursday","uniqueKey":"cycles.schedule.thu","typeLabel":"object"},"fri":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.fri.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.fri.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.fri.active","typeLabel":"boolean"}},"description":"Friday","uniqueKey":"cycles.schedule.fri","typeLabel":"object"},"sat":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.sat.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.sat.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.sat.active","typeLabel":"boolean"}},"description":"Saturday","uniqueKey":"cycles.schedule.sat","typeLabel":"object"},"sun":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.sun.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"cycles.schedule.sun.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"cycles.schedule.sun.active","typeLabel":"boolean"}},"description":"Sunday","uniqueKey":"cycles.schedule.sun","typeLabel":"object"}},"description":"Per-day schedule. Only used when `mode` = `scheduled`.","uniqueKey":"cycles.schedule","typeLabel":"object"},"schedule_start_date":{"oneOf":[{"type":"string","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"cycles.schedule_start_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"cycles.schedule_start_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"cycles.schedule_start_date","typeLabel":"string\u003cdate> | null"},"schedule_end_date":{"oneOf":[{"type":"string","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"cycles.schedule_end_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"cycles.schedule_end_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"cycles.schedule_end_date","typeLabel":"string\u003cdate> | null"}},"uniqueKey":"cycles","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","description":"\u003cstring>","timezone":"\u003cstring>","retries":2,"message_limit":5000,"scheduling":{"mon":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"tue":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"wed":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"thu":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"fri":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sat":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sun":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true}},"first_message":"\u003cstring>","template":"\u003cstring>","template_alt":"\u003cstring>","cycles":{"enabled":true,"max_iterations":7,"cooldown_minutes":720,"filter_statuses":["\u003cstring>"],"filter_tags":["\u003cstring>"],"schedule":{"mon":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"tue":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"wed":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"thu":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"fri":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sat":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sun":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true}},"schedule_start_date":"2023-12-25","schedule_end_date":"2023-12-25"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"cb68f979-f780-41be-a0fc-06462d885d7e":{"description":"Campaign updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"campaign":{"type":"object","description":"Single Campaign detail with nested agent, integration and cycles config. The `analytics` field is included only when a snapshot is available for the campaign.","properties":{"id":{"description":"Unique identifier for the Campaign","type":"integer","uniqueKey":"campaign.id","typeLabel":"integer"},"name":{"description":"Name of the Campaign","type":"string","uniqueKey":"campaign.name","typeLabel":"string"},"status":{"description":"Current status of the Campaign","type":"string","enum":["pending","ready","active","inactive","cooldown","finished"],"uniqueKey":"campaign.status","typeLabel":"enum\u003cstring>"},"integration":{"oneOf":[{"description":"Nested {id, type} of the integration the Campaign was created on","type":"object","properties":{"id":{"type":"string","uniqueKey":"campaign.integration.oneOf.0.id","typeLabel":"string"},"type":{"type":"string","enum":["phone_call","whatsapp"],"uniqueKey":"campaign.integration.oneOf.0.type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"campaign.integration.oneOf.0","typeLabel":"object"},{"description":"Nested {id, type} of the integration the Campaign was created on","type":"null","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["phone_call","whatsapp"]}},"uniqueKey":"campaign.integration.oneOf.1","typeLabel":"null"}],"uniqueKey":"campaign.integration","typeLabel":"object | null"},"agent":{"type":"object","properties":{"id":{"type":"string","format":"uuid4","uniqueKey":"campaign.agent.id","typeLabel":"string\u003cuuid4>"},"name":{"type":"string","uniqueKey":"campaign.agent.name","typeLabel":"string"}},"uniqueKey":"campaign.agent","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","uniqueKey":"campaign.created_at","typeLabel":"string\u003cdate-time>"},"scheduling":{"type":"object","properties":{"mon":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.mon.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.mon.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.mon.active","typeLabel":"boolean"}},"description":"Monday","uniqueKey":"campaign.scheduling.mon","typeLabel":"object"},"tue":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.tue.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.tue.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.tue.active","typeLabel":"boolean"}},"description":"Tuesday","uniqueKey":"campaign.scheduling.tue","typeLabel":"object"},"wed":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.wed.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.wed.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.wed.active","typeLabel":"boolean"}},"description":"Wednesday","uniqueKey":"campaign.scheduling.wed","typeLabel":"object"},"thu":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.thu.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.thu.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.thu.active","typeLabel":"boolean"}},"description":"Thursday","uniqueKey":"campaign.scheduling.thu","typeLabel":"object"},"fri":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.fri.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.fri.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.fri.active","typeLabel":"boolean"}},"description":"Friday","uniqueKey":"campaign.scheduling.fri","typeLabel":"object"},"sat":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.sat.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.sat.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.sat.active","typeLabel":"boolean"}},"description":"Saturday","uniqueKey":"campaign.scheduling.sat","typeLabel":"object"},"sun":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.sun.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.scheduling.sun.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.scheduling.sun.active","typeLabel":"boolean"}},"description":"Sunday","uniqueKey":"campaign.scheduling.sun","typeLabel":"object"}},"uniqueKey":"campaign.scheduling","typeLabel":"object"},"cycles":{"type":"object","description":"Cycles configuration block. Phone-call campaigns only.","properties":{"enabled":{"type":"boolean","description":"Whether cycles are enabled. Immutable after creation.","uniqueKey":"campaign.cycles.enabled","typeLabel":"boolean"},"mode":{"type":"string","enum":["cooldown","scheduled"],"description":"Cycle mode. Immutable after creation.","uniqueKey":"campaign.cycles.mode","typeLabel":"enum\u003cstring>"},"max_iterations":{"type":"integer","minimum":2,"maximum":12,"uniqueKey":"campaign.cycles.max_iterations","typeLabel":"integer"},"cooldown_minutes":{"type":"integer","minimum":0,"maximum":1440,"uniqueKey":"campaign.cycles.cooldown_minutes","typeLabel":"integer"},"filter_statuses":{"type":"array","items":{"type":"string","uniqueKey":"campaign.cycles.filter_statuses.items.[INDEX]","typeLabel":"string"},"description":"Contact statuses excluded from the next iteration.","uniqueKey":"campaign.cycles.filter_statuses","typeLabel":"string[]"},"filter_tags":{"type":"array","items":{"type":"string","uniqueKey":"campaign.cycles.filter_tags.items.[INDEX]","typeLabel":"string"},"description":"Thread tag ids whose contacts are excluded from the next iteration. Input-only; not returned on the detail response.","uniqueKey":"campaign.cycles.filter_tags","typeLabel":"string[]"},"schedule":{"type":"object","properties":{"mon":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.mon.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.mon.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.mon.active","typeLabel":"boolean"}},"description":"Monday","uniqueKey":"campaign.cycles.schedule.mon","typeLabel":"object"},"tue":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.tue.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.tue.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.tue.active","typeLabel":"boolean"}},"description":"Tuesday","uniqueKey":"campaign.cycles.schedule.tue","typeLabel":"object"},"wed":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.wed.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.wed.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.wed.active","typeLabel":"boolean"}},"description":"Wednesday","uniqueKey":"campaign.cycles.schedule.wed","typeLabel":"object"},"thu":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.thu.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.thu.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.thu.active","typeLabel":"boolean"}},"description":"Thursday","uniqueKey":"campaign.cycles.schedule.thu","typeLabel":"object"},"fri":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.fri.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.fri.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.fri.active","typeLabel":"boolean"}},"description":"Friday","uniqueKey":"campaign.cycles.schedule.fri","typeLabel":"object"},"sat":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.sat.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.sat.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.sat.active","typeLabel":"boolean"}},"description":"Saturday","uniqueKey":"campaign.cycles.schedule.sat","typeLabel":"object"},"sun":{"type":"object","properties":{"startTime":{"description":"Start time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.sun.startTime","typeLabel":"string"},"stopTime":{"description":"End time of the Campaign on Monday","type":"string","uniqueKey":"campaign.cycles.schedule.sun.stopTime","typeLabel":"string"},"active":{"description":"Boolean describing if the Campaign is active on Monday","type":"boolean","uniqueKey":"campaign.cycles.schedule.sun.active","typeLabel":"boolean"}},"description":"Sunday","uniqueKey":"campaign.cycles.schedule.sun","typeLabel":"object"}},"description":"Per-day schedule. Only used when `mode` = `scheduled`.","uniqueKey":"campaign.cycles.schedule","typeLabel":"object"},"schedule_start_date":{"oneOf":[{"type":"string","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"campaign.cycles.schedule_start_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"campaign.cycles.schedule_start_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"campaign.cycles.schedule_start_date","typeLabel":"string\u003cdate> | null"},"schedule_end_date":{"oneOf":[{"type":"string","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"campaign.cycles.schedule_end_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Only used when `mode` = `scheduled`.","uniqueKey":"campaign.cycles.schedule_end_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"campaign.cycles.schedule_end_date","typeLabel":"string\u003cdate> | null"}},"uniqueKey":"campaign.cycles","typeLabel":"object"},"analytics":{"description":"Analytics snapshot for the Campaign. Shape depends on `integration.type`; see `CampaignAnalyticsPhoneCall` and `CampaignAnalyticsWhatsApp`.","type":"object","uniqueKey":"campaign.analytics","typeLabel":"object"}},"uniqueKey":"campaign","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"campaign":{"id":123,"name":"\u003cstring>","status":"pending","integration":{"id":"\u003cstring>","type":"phone_call"},"agent":{"id":"\u003cstring>","name":"\u003cstring>"},"created_at":"2023-11-07T05:31:56Z","scheduling":{"mon":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"tue":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"wed":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"thu":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"fri":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sat":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sun":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true}},"cycles":{"enabled":true,"mode":"cooldown","max_iterations":7,"cooldown_minutes":720,"filter_statuses":["\u003cstring>"],"filter_tags":["\u003cstring>"],"schedule":{"mon":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"tue":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"wed":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"thu":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"fri":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sat":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true},"sun":{"startTime":"\u003cstring>","stopTime":"\u003cstring>","active":true}},"schedule_start_date":"2023-12-25","schedule_end_date":"2023-12-25"},"analytics":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"015e4506-cabc-412f-954b-a9b1333a4e93":{"description":"Invalid input, immutable field, cycles not enabled, or scheduled-mode-only field misuse","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned by the v1.0 campaigns API.","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Stable, UPPER_SNAKE_CASE error key.","enum":["FORBIDDEN","NOT_FOUND","RATE_LIMITED","SERVER_ERROR","INVALID_REQUEST","INVALID_STATUS","IMMUTABLE_FIELD","UNKNOWN_ACTION","AGENT_NOT_FOUND","INTEGRATION_NOT_FOUND","INVALID_INTEGRATION_TYPE","INVALID_FILTER_TAG","INVALID_PHONE_NUMBER","MISSING_CONTACT","CONTACT_NOT_FOUND","CONTACT_NOT_DELETABLE","CAMPAIGN_FINISHED","CYCLES_NOT_ENABLED","SCHEDULED_MODE_ONLY","INVALID_STATUS_TRANSITION","BILLING_LIMIT_REACHED"],"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"field":{"type":"string","description":"Set when `error` is `IMMUTABLE_FIELD`; identifies the offending field path.","uniqueKey":"field","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"FORBIDDEN","message":"\u003cstring>","field":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"53b03673-590b-4eb7-88e1-a5e95a674e66":{"description":"Unauthorized","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"error":{"type":"integer","format":"int32","isRequired":true,"uniqueKey":"error","typeLabel":"integer\u003cint32>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":123,"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"45605ab3-90d4-4d4b-84ff-34a0e648109e":{"description":"Campaign not found","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned by the v1.0 campaigns API.","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Stable, UPPER_SNAKE_CASE error key.","enum":["FORBIDDEN","NOT_FOUND","RATE_LIMITED","SERVER_ERROR","INVALID_REQUEST","INVALID_STATUS","IMMUTABLE_FIELD","UNKNOWN_ACTION","AGENT_NOT_FOUND","INTEGRATION_NOT_FOUND","INVALID_INTEGRATION_TYPE","INVALID_FILTER_TAG","INVALID_PHONE_NUMBER","MISSING_CONTACT","CONTACT_NOT_FOUND","CONTACT_NOT_DELETABLE","CAMPAIGN_FINISHED","CYCLES_NOT_ENABLED","SCHEDULED_MODE_ONLY","INVALID_STATUS_TRANSITION","BILLING_LIMIT_REACHED"],"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"field":{"type":"string","description":"Set when `error` is `IMMUTABLE_FIELD`; identifies the offending field path.","uniqueKey":"field","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"FORBIDDEN","message":"\u003cstring>","field":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"435c8d88-6bda-4728-8ddf-46250aa7d01b":{"description":"Campaign is finished","content":{"application/json":{"schema":{"type":"object","description":"Standard error envelope returned by the v1.0 campaigns API.","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"string","description":"Stable, UPPER_SNAKE_CASE error key.","enum":["FORBIDDEN","NOT_FOUND","RATE_LIMITED","SERVER_ERROR","INVALID_REQUEST","INVALID_STATUS","IMMUTABLE_FIELD","UNKNOWN_ACTION","AGENT_NOT_FOUND","INTEGRATION_NOT_FOUND","INVALID_INTEGRATION_TYPE","INVALID_FILTER_TAG","INVALID_PHONE_NUMBER","MISSING_CONTACT","CONTACT_NOT_FOUND","CONTACT_NOT_DELETABLE","CAMPAIGN_FINISHED","CYCLES_NOT_ENABLED","SCHEDULED_MODE_ONLY","INVALID_STATUS_TRANSITION","BILLING_LIMIT_REACHED"],"uniqueKey":"error","typeLabel":"enum\u003cstring>"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"field":{"type":"string","description":"Set when `error` is `IMMUTABLE_FIELD`; identifies the offending field path.","uniqueKey":"field","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":"FORBIDDEN","message":"\u003cstring>","field":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2abef093-c110-4cfb-9665-f370af43e5e8":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","scopes":[]}}},"servers":{"c8d15ecb-4ef9-4af2-8da9-65bf53121690":{"url":"https://api.altur.io/api/v1.0"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","scopes":[]},"schema":{"title":"Authorization","type":"string","description":"Add `api-key YOUR_API_SECRET_KEY` as the value of the `Authorization` header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"Authorization"}],"title":"apiKeyAuth"}]},"originalFileLocation":"en/api-reference/openapi.json"},"subdomain":"altur","siteName":"Altur","title":"Actualizar Campaña - Altur","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/campaigns/update","matchLevel":1},"es":{"href":"/es/api-reference/campaigns/update","matchLevel":0}}},"lastModified":"2026-06-18T00:20:39.267Z","originalFileLocation":"es/api-reference/campaigns/update.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Altur\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Actualizar Campaña - Altur\">\u003cmeta data-mint-head property=\"og:description\" content=\"Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Altur\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.altur.io/es/api-reference/campaigns/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://altur.mintlify.site/_mintlify/api/og/v2?division=Campa%C3%B1as\u0026amp;title=Actualizar+Campa%C3%B1a\u0026amp;description=Actualizaci%C3%B3n+parcial+de+una+Campa%C3%B1a.+Los+campos+inmutables+%28%60agent_id%60%2C+%60integration_id%60%2C+%60integration_type%60%2C+%60cycles.enabled%60%2C+%60cycles.mode%60%29+no+se+pueden+mod\u0026amp;theme=d457f886f343045339d35962\u0026amp;signature=181f5bd084f4febc9cd80da091d0099d94aef820ee17b577ebe7683c6adcebfa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Actualizar Campaña - Altur\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://altur.mintlify.site/_mintlify/api/og/v2?division=Campa%C3%B1as\u0026amp;title=Actualizar+Campa%C3%B1a\u0026amp;description=Actualizaci%C3%B3n+parcial+de+una+Campa%C3%B1a.+Los+campos+inmutables+%28%60agent_id%60%2C+%60integration_id%60%2C+%60integration_type%60%2C+%60cycles.enabled%60%2C+%60cycles.mode%60%29+no+se+pueden+mod\u0026amp;theme=d457f886f343045339d35962\u0026amp;signature=181f5bd084f4febc9cd80da091d0099d94aef820ee17b577ebe7683c6adcebfa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/altur/-L_trUOSQMv2YyeK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Altur\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0066FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.altur.io/es/api-reference/campaigns/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/campaigns/update.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.altur.io/es/api-reference/campaigns/update\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.altur.io/en/api-reference/campaigns/update\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.altur.io/en/api-reference/campaigns/update\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.altur.io/#organization\",\"name\":\"Altur\",\"url\":\"https://docs.altur.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/altur/D4WthK6Jl2QiKslz/logo/light.svg?fit=max\u0026auto=format\u0026n=D4WthK6Jl2QiKslz\u0026q=85\u0026s=20f8f677ccc5d294c37dc46192e3ea74\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.altur.io#website\",\"name\":\"Altur\",\"url\":\"https://docs.altur.io\",\"publisher\":{\"@id\":\"https://docs.altur.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.altur.io/es/api-reference/campaigns/update#webpage\",\"url\":\"https://docs.altur.io/es/api-reference/campaigns/update\",\"name\":\"Actualizar Campaña\",\"description\":\"Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.\",\"dateModified\":\"2026-06-18T00:20:39.267Z\",\"isPartOf\":{\"@id\":\"https://docs.altur.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.altur.io/es/api-reference/campaigns/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.altur.io/es/api-reference/campaigns/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints de API\",\"item\":\"https://docs.altur.io/es/api-reference/calls/start\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Campañas\",\"item\":\"https://docs.altur.io/es/api-reference/campaigns/retrieve\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Actualizar Campaña\",\"item\":\"https://docs.altur.io/es/api-reference/campaigns/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.altur.io/es/api-reference/campaigns/update#apireference\",\"headline\":\"Actualizar Campaña\",\"name\":\"Actualizar Campaña\",\"description\":\"Actualización parcial de una Campaña. Los campos inmutables (agent_id, integration_id, integration_type, cycles.enabled, cycles.mode) no se pueden modificar y devuelven IMMUTABLE_FIELD. Las campañas finalizadas son de solo lectura.\",\"url\":\"https://docs.altur.io/es/api-reference/campaigns/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.altur.io/es/api-reference/campaigns/update#webpage\"},\"dateModified\":\"2026-06-18T00:20:39.267Z\",\"publisher\":{\"@id\":\"https://docs.altur.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.altur.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Altur\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Altur","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/en/api-reference/campaigns/update"}]},{"language":"es","tabs":[{"tab":"Documentación","pages":[{"title":"Documentación","href":"/es/documentation/introduction"}]},{"tab":"Referencia de API","groups":[{"group":"Introducción","pages":[{"title":"Descripción general de la API","href":"/es/api-reference/introduction"},{"title":"Authentication","href":"/es/api-reference/authentication"}]},{"group":"Endpoints de API","pages":[{"group":"Llamadas","icon":"phone","pages":[{"title":"Start Call","openapi":"POST /call","href":"/es/api-reference/calls/start"},{"title":"Retrieve Call","openapi":"GET /call/{id}","href":"/es/api-reference/calls/retrieve"},{"title":"Retrieve Call Recording","openapi":"GET /call/{id}/recording","href":"/es/api-reference/calls/retrieve-recording"}]},{"group":"Campañas","icon":"megaphone","pages":[{"title":"Listar Campañas","openapi":"GET /campaigns","href":"/es/api-reference/campaigns/retrieve"},{"title":"Detalle de Campaña","openapi":"GET /campaigns/{id}","href":"/es/api-reference/campaigns/retrieve-detail"},{"title":"Crear Campaña","openapi":"POST /campaigns","description":"Crea una nueva Campaña para tu organización. Usa `integration_type` para seleccionar entre llamada telefónica o WhatsApp; los campos exclusivos del canal contrario son rechazados.","href":"/es/api-reference/campaigns/create"},{"title":"Actualizar Campaña","openapi":"PATCH /campaigns/{id}","href":"/es/api-reference/campaigns/update"},{"title":"Acciones de Ciclo de Vida","openapi":"POST /campaigns/{id}/{action}","description":"Aplica una acción de ciclo de vida a una Campaña. Acciones válidas: `activate`, `pause`, `archive`, `resume`. La acción es idempotente: aplicar una acción cuando la campaña ya está en el estado destino es un no-op exitoso.","href":"/es/api-reference/campaigns/lifecycle"},{"title":"Listar Contactos de Campaña","openapi":"GET /campaigns/{id}/contacts","href":"/es/api-reference/campaigns/retrieve-contacts"},{"title":"Agregar Contactos a Campaña","openapi":"POST /campaigns/{id}/contacts","href":"/es/api-reference/campaigns/create-contacts"},{"title":"Detalle de Contacto de Campaña","openapi":"GET /campaigns/{id}/contacts/{contact_id}","href":"/es/api-reference/campaigns/retrieve-contact"},{"title":"Eliminar Contacto de Campaña","openapi":"DELETE /campaigns/{id}/contacts/{contact_id}","href":"/es/api-reference/campaigns/delete-contact"},{"title":"Listar Llamadas de Campaña","openapi":"GET /campaigns/{id}/calls","href":"/es/api-reference/campaigns/retrieve-calls"}]},{"group":"Mensajes","icon":"message","pages":[{"title":"Send Message","openapi":"POST /message","href":"/es/api-reference/messages/send"},{"title":"Get Messages","openapi":"GET /message/{thread_id}","href":"/es/api-reference/messages/retrieve"}]},{"group":"Threads","icon":"messages","pages":[{"title":"Retrieve Thread","openapi":"GET /thread/{id}","href":"/es/api-reference/threads/retrieve"}]},{"group":"EndUsers","icon":"user","pages":[{"title":"Create EndUser","openapi":"POST /enduser","href":"/es/api-reference/endusers/create"},{"title":"Retrieve EndUser","openapi":"GET /enduser/{id}","href":"/es/api-reference/endusers/retrieve"},{"title":"Update EndUser","openapi":"PUT /enduser/{id}","href":"/es/api-reference/endusers/update"},{"title":"Delete EndUser","openapi":"DELETE /enduser/{id}","href":"/es/api-reference/endusers/delete"}]}]},{"group":"Webhooks","pages":[{"title":"Descripción general de Webhooks","icon":"webhook","iconType":"regular","href":"/es/api-reference/webhooks/overview"},{"group":"Eventos de Webhook","icon":"bolt","pages":[{"title":"on_call_end","href":"/es/api-reference/webhooks/on-call-end"},{"title":"transfer_started","href":"/es/api-reference/webhooks/transfer-started"},{"title":"transfer_completed","href":"/es/api-reference/webhooks/transfer-completed"},{"title":"campaign.status_changed","href":"/es/api-reference/webhooks/campaign-status-changed"},{"title":"campaign.cycle_completed","href":"/es/api-reference/webhooks/campaign-cycle-completed"}]}]}]}]}]},"basePath":"","title":"Actualizar Campaña - Altur","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}