---
updatedAt: 2026-05-04T20:47:50.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Update program(s) parameters

Update program parameter values for one or more programs. 

For more information, refer to the [program parameters](doc:program-parameters-reference-table) reference table.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Platform setup - Programs",
    "description": "Endpoints to handle Programs",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "tags": [
    {
      "name": "Parameters",
      "description": "Manage program parameters"
    }
  ],
  "components": {
    "schemas": {
      "FloatParameterValue": {
        "type": "number",
        "format": "float",
        "description": "Parameter value",
        "example": 1.5
      },
      "handler.HTTPError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "Bad request code",
            "example": "EOA0017"
          },
          "message": {
            "type": "string",
            "description": "Bad request response",
            "example": "Bad Request"
          }
        }
      },
      "ParameterID": {
        "description": "Parameter ID. Parameter IDs can change depending on the environment and, consequently, are not listed in the [program parameters reference table](https://developers.pismo.io/pismo-docs/docs/program-parameters-reference-table). Use the [List program parameters](https://developers.pismo.io/pismo-docs/reference/programparameter) endpoint to get the IDs (`parameter_id` in the response) for your program parameters.\n",
        "example": 1,
        "type": "integer",
        "format": "int64"
      },
      "ProgramID": {
        "type": "integer",
        "format": "int64",
        "description": "Program ID",
        "example": 12345
      },
      "ProgramIDs": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ProgramID"
        }
      },
      "SetProgramParameter": {
        "type": "object",
        "properties": {
          "parameter_id": {
            "$ref": "#/components/schemas/ParameterID"
          },
          "value": {
            "$ref": "#/components/schemas/FloatParameterValue"
          },
          "programs": {
            "$ref": "#/components/schemas/ProgramIDs"
          }
        }
      },
      "SetProgramsParameters": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/SetProgramParameter"
        }
      }
    },
    "responses": {
      "204NoContent": {
        "description": "No Content"
      },
      "400BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/handler.HTTPError"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must be previoulsy authenticated."
      }
    }
  },
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "paths": {
    "/programs/v1/programs/parameters/batch": {
      "post": {
        "summary": "Update program(s) parameters",
        "description": "Update program parameter values for one or more programs. \n\nFor more information, refer to the [program parameters](https://developers.pismo.io/pismo-docs/docs/program-parameters-reference-table) reference table.\n",
        "operationId": "setProgramsParameters",
        "tags": [
          "Parameters"
        ],
        "requestBody": {
          "description": "Update parameter for one or more programs request",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetProgramsParameters"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "$ref": "#/components/responses/204NoContent"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          }
        }
      }
    }
  }
}
```