PUT
/
v3
/
orgs
/
{orgId}
curl --request PUT \
  --url https://api.ctrl-hub.com/v3/orgs/{orgId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": {
    "type": "organisations",
    "id": "7e0c875a-fd47-401d-bd25-4278ed58d721",
    "attributes": {
      "name": "Ctrl Hub",
      "description": "Ctrl Hub deliver best in class software for managing your compliance, safety, risk and resource requirements"
    }
  }
}'
{
  "data": {
    "type": "organisations",
    "id": "7e0c875a-fd47-401d-bd25-4278ed58d721",
    "attributes": {
      "name": "Ctrl Hub",
      "slug": "ctrl-hub",
      "description": "Ctrl Hub deliver best in class software for managing your compliance, safety, risk and resource requirements",
      "settings": {
        "nomenclature": {
          "governance": {
            "schemes": [
              {
                "language": "en-GB",
                "singular": "Scheme",
                "plural": "Schemes"
              }
            ],
            "work_orders": [
              {
                "language": "en-GB",
                "singular": "Work Order",
                "plural": "Work Orders"
              }
            ],
            "operations": [
              {
                "language": "en-GB",
                "singular": "Operation",
                "plural": "Operations"
              }
            ]
          }
        }
      }
    },
    "meta": {
      "created_at": "2024-06-13T07:15:23.000Z",
      "status": "active"
    },
    "links": {
      "self": "https://api.ctrl-hub.com/v3/orgs/7e0c875a-fd47-401d-bd25-4278ed58d721"
    }
  }
}

An organisation slug is immutable and cannot be updated

Authorizations

​
Authorization
string
header
required

To understand how to authenticate, see the auth docs

Path Parameters

​
orgId
string
required

The ID of the organisation

Example:

"cc9746e0-9286-4575-ae0b-ac1b0fe873a6"

Body

application/json
​
data
object

Response

200
application/json
​
data
object