Update Program

put

Path parameters

idstringRequired

Body

multipart/form-dataapplication/json

iconstring · binaryOptional

Responses

200

OK

application/json

idstringOptional

namestringOptional

shortDescriptionstring · nullableOptional

longDescriptionstring · nullableOptional

websitestringOptional

iconstringRead-onlyOptional

statusall ofOptional

string · enumOptionalPossible values:

applicableToall ofOptional

string · enumOptionalPossible values:

400

Bad Request

application/json

403

Forbidden

application/json

500

Internal Server Error

put

/public/v1/program/programs/{id}

HTTPcURLJavaScriptPython

PUT /public/v1/program/programs/{id} HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 434

{
  "program": {
    "Program.Node.Name": "text",
    "Program.Node.Children": [
      {
        "name": "text"
      }
    ],
    "Program.Path": "text",
    "Program.Data.Name": "text",
    "Program.Data.ShortDescription": "text",
    "Program.Data.LongDescription": "text",
    "Program.Data.Website": "text",
    "Program.Data.Eligibility.Client": true,
    "Program.Data.Eligibility.Partner": true,
    "Program.Data.ApplicableTo": "Buyer",
    "Program.Data.Products": [
      {
        "id": "text"
      }
    ],
    "Program.IsDefined": true
  },
  "icon": "binary"
}

multipart/form-dataapplication/json

{
  "id": "text",
  "audit": {
    "created": {
      "at": "2026-02-19T20:39:37.862Z",
      "by": {}
    },
    "updated": {
      "at": "2026-02-19T20:39:37.862Z",
      "by": {}
    },
    "published": {
      "at": "2026-02-19T20:39:37.862Z",
      "by": {}
    },
    "unpublished": {
      "at": "2026-02-19T20:39:37.862Z",
      "by": {}
    }
  },
  "$meta": {
    "omitted": [
      "text"
    ]
  },
  "name": "text",
  "shortDescription": "text",
  "longDescription": "text",
  "website": "text",
  "icon": "text",
  "status": "text",
  "eligibility": {
    "client": true,
    "partner": true
  },
  "applicableTo": "text",
  "products": [
    {
      "id": "text",
      "audit": {
        "created": {},
        "updated": {},
        "published": {},
        "pending": {},
        "unpublished": {}
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "name": "text",
      "shortDescription": "text",
      "longDescription": "text",
      "externalIds": {
        "operations": "text",
        "defaultErpItem": "text"
      },
      "website": "text",
      "icon": "text",
      "status": "text",
      "vendor": {
        "id": "text",
        "icon": "text",
        "type": "text",
        "status": "text",
        "name": "text"
      },
      "settings": {
        "productOrdering": true,
        "productRequests": {
          "enabled": true,
          "name": "text",
          "label": "text"
        },
        "itemSelection": true,
        "orderQueueChanges": true,
        "preValidation": {
          "purchaseOrderDraft": true,
          "purchaseOrderQuerying": true,
          "changeOrderDraft": true,
          "configurationOrderDraft": true,
          "terminationOrder": true,
          "productRequest": true
        },
        "splitBilling": {
          "enabled": true,
          "type": "text"
        },
        "subscriptionCessation": {
          "enabled": true,
          "mode": "Termination"
        }
      },
      "statistics": {
        "itemCount": 1,
        "ordersPlacedCount": 1,
        "agreementCount": 1,
        "subscriptionCount": 1,
        "requestCount": 1
      }
    }
  ],
  "vendor": {
    "id": "text",
    "icon": "text",
    "type": "text",
    "status": "text",
    "name": "text"
  },
  "settings": {
    "newCertificateAutoapprove": true,
    "programEnrollment": true,
    "programLink": true,
    "terminateOnExpiration": {
      "enabled": true,
      "duration": 1
    },
    "preValidation": {
      "enrollmentDraft": true,
      "enrollmentQuerying": true,
      "reEnrollment": true
    }
  },
  "statistics": {
    "certificates": 1
  }
}