---
title: "Modify campaign"
url: "https://earlyaccess.developers.bynder.com/apis/workflow-campaigns-api-1/versions/e0ad0bb4-8312-4ba5-bc53-d0218db2d92e/paths/api-workflow-campaigns-id/put"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/workflow-campaigns-api-1/versions/e0ad0bb4-8312-4ba5-bc53-d0218db2d92e.md

# Modify campaign

`PUT` `/api/workflow/campaigns/{id}`

Requires the CAMPAIGNEDIT security role.

## Path parameters

- `id` (string, required)

## Request body (required)

Content types: `application/json`

## Responses

- `201` - Campaign modified successfully

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Workflow Campaigns API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}
paths:
  /api/workflow/campaigns/{id}:
    put:
      description: Requires the CAMPAIGNEDIT security role.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            example: 00000000-0000-0000-0000-000000000000
            type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                campaignMetaproperties:
                  additionalProperties:
                    example: 00000000-0000-0000-0000-000000000000
                    type: string
                  type: object
                closed:
                  example: false
                  type: boolean
                dateStart:
                  example: 2015-01-01T00:00:00
                  format: date
                  type: string
                deadline:
                  example: 2015-09-04T00:00:00
                  format: date
                  type: string
                description:
                  example: Campaign for managing examples
                  type: string
                key:
                  example: excp
                  type: string
                name:
                  example: Example campaign
                  type: string
                responsibleID:
                  example: 00000000-0000-0000-0000-000000000000
                  type: string
              type: object
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                properties:
                  id:
                    example: "00000000000000000000000000000000"
                    type: string
                type: object
          description: Campaign modified successfully
      security:
        - OAuth2:
            - CAMPAIGNEDIT
        - permanentToken:
            - CAMPAIGNEDIT
      summary: Modify campaign
      tags:
        - Campaigns
security:
  - OAuth2:
      - CAMPAIGNEDIT
  - permanentToken:
      - CAMPAIGNEDIT
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            CAMPAIGNADD: ""
            CAMPAIGNEDIT: ""
            CAMPAIGNOVERVIEW: ""
            CAMPAIGNREMOVE: ""
            CAMPAIGNWRITE: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            CAMPAIGNADD: ""
            CAMPAIGNEDIT: ""
            CAMPAIGNOVERVIEW: ""
            CAMPAIGNREMOVE: ""
            CAMPAIGNWRITE: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```