Update account

Update account

put

Update account. Available for Operations account with platform account management permissions. Accepts application/json or multipart/form-data (with optional icon). Updates account fields such as name, address, website, and description. Returns the updated account object.

Path parameters

idstringRequired

Account identifier.

Body

multipart/form-dataapplication/json

logostring · binaryOptional

Responses

200

OK

application/json

idstringOptional

namestringOptional

iconstring · nullableOptional

revisioninteger · int32Optional

typestring · enumOptionalPossible values:

statusstring · enumOptionalPossible values:

externalIdstring · nullableOptional

externalNamestring · nullableOptional

technicalSupportEmailstring · nullableOptional

websitestring · nullableOptional

descriptionstring · nullableOptional

defaultLanguageCodestring · nullableOptional

400

Bad Request

application/json

404

Not Found

application/json

put

/public/v1/accounts/accounts/{id}

HTTPcURLJavaScriptPython

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

{
  "account": {
    "ExternalIds.PyraTenantId": "123e4567-e89b-12d3-a456-426614174000",
    "ExternalId": "text",
    "ExternalName": "text",
    "Address.AddressLine1": "text",
    "Address.AddressLine2": "text",
    "Address.PostCode": "text",
    "Address.City": "text",
    "Address.State": "text",
    "Address.Country": "text",
    "TechnicalSupportEmail": "text",
    "Website": "text",
    "Description": "text",
    "Groups": [
      {
        "id": "text",
        "audit": {
          "created": {
            "at": "2026-05-15T14:41:19.876Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          },
          "updated": {
            "at": "2026-05-15T14:41:19.876Z",
            "by": {
              "id": "text",
              "name": "text",
              "icon": "text",
              "revision": 1
            }
          }
        },
        "$meta": {
          "omitted": [
            "text"
          ]
        },
        "name": "text",
        "revision": 1,
        "description": "text",
        "account": {
          "id": "text",
          "name": "text",
          "icon": "text",
          "revision": 1,
          "type": "Client",
          "status": "Active"
        },
        "modules": [
          {
            "id": "text",
            "name": "text",
            "revision": 1,
            "description": "text",
            "filters": {
              "group.buyers": [
                "text"
              ]
            },
            "settings": {
              "configurable": true,
              "default": true,
              "paid": true,
              "type": [
                "text"
              ],
              "obsolete": true,
              "eligibility": {
                "multi": true,
                "single": true
              }
            }
          }
        ],
        "logo": "text",
        "isDefault": true,
        "users": [
          {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        ],
        "extensions": [
          {
            "id": "text",
            "audit": {
              "created": {
                "at": "2026-05-15T14:41:19.876Z",
                "by": {
                  "id": "text",
                  "name": "text",
                  "icon": "text",
                  "revision": 1
                }
              },
              "updated": {
                "at": "2026-05-15T14:41:19.876Z",
                "by": {
                  "id": "text",
                  "name": "text",
                  "icon": "text",
                  "revision": 1
                }
              }
            },
            "$meta": {
              "omitted": [
                "text"
              ]
            },
            "name": "text",
            "icon": "text",
            "revision": 1,
            "status": "Draft"
          }
        ],
        "buyers": [
          {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        ]
      }
    ],
    "Eligibility.Client": true,
    "Eligibility.Partner": true,
    "DefaultLanguageCode": "text",
    "Type": "Client",
    "Status": "Active",
    "Metadata.OmittedProperties": [
      "text"
    ],
    "Name": "text",
    "Icon": "text",
    "Revision": 1,
    "Audit.Created.At": "2026-05-15T14:41:19.876Z",
    "Audit.Created.ById": "text",
    "Audit.Created.By.Type": "User",
    "Audit.Created.By.Metadata.OmittedProperties": [
      "text"
    ],
    "Audit.Created.By.Name": "text",
    "Audit.Created.By.Icon": "text",
    "Audit.Created.By.Revision": 1,
    "Audit.Created.By.Audit.Created": {
      "at": "2026-05-15T14:41:19.876Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "Audit.Created.By.Audit.Updated.At": "2026-05-15T14:41:19.876Z",
    "Audit.Created.By.Audit.Updated.ById": "text",
    "Audit.Created.By.Audit.Updated.By": {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-05-15T14:41:19.876Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-05-15T14:41:19.876Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "name": "text",
      "icon": "text",
      "revision": 1
    },
    "Audit.Created.By.Id": "text",
    "Audit.Updated.At": "2026-05-15T14:41:19.876Z",
    "Audit.Updated.ById": "text",
    "Audit.Updated.By.Type": "User",
    "Audit.Updated.By.Metadata.OmittedProperties": [
      "text"
    ],
    "Audit.Updated.By.Name": "text",
    "Audit.Updated.By.Icon": "text",
    "Audit.Updated.By.Revision": 1,
    "Audit.Updated.By.Audit.Created.At": "2026-05-15T14:41:19.876Z",
    "Audit.Updated.By.Audit.Created.ById": "text",
    "Audit.Updated.By.Audit.Created.By": {
      "id": "text",
      "audit": {
        "created": {
          "at": "2026-05-15T14:41:19.876Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        },
        "updated": {
          "at": "2026-05-15T14:41:19.876Z",
          "by": {
            "id": "text",
            "name": "text",
            "icon": "text",
            "revision": 1
          }
        }
      },
      "$meta": {
        "omitted": [
          "text"
        ]
      },
      "name": "text",
      "icon": "text",
      "revision": 1
    },
    "Audit.Updated.By.Audit.Updated": {
      "at": "2026-05-15T14:41:19.876Z",
      "by": {
        "id": "text",
        "name": "text",
        "icon": "text",
        "revision": 1
      }
    },
    "Audit.Updated.By.Id": "text",
    "Id": "text"
  },
  "logo": "binary"
}

multipart/form-dataapplication/json

{
  "id": "ACC-1234-1234",
  "revision": 2,
  "name": "Contoso Ltd",
  "icon": "/static/accounts/ACC-1234-1234/logo.png"
}