Skip to main content
POST
/
organizations
/
{orgId}
/
resourcegroups
/
{type}
Create ResourceGroup
curl --request POST \
  --url https://api.m3ter.com/organizations/{orgId}/resourcegroups/{type} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "version": 123
}
'
{
  "id": "<string>",
  "version": 123,
  "name": "<string>",
  "dtCreated": "2023-11-07T05:31:56Z",
  "dtLastModified": "2023-11-07T05:31:56Z",
  "createdBy": "<string>",
  "lastModifiedBy": "<string>"
}

Authorizations

Authorization
string
header
required

m3ter supports machine to machine authentication using the clientCredentials OAuth2 flow.

The authorizationCode flow controls access for human users via the m3ter Console application.

Path Parameters

orgId
string
required

UUID of the organization

type
string
required

The type of resource

Body

application/json
name
string
required
Required string length: 1 - 100
version
integer<int64>

Response

Return the new ResourceGroup

id
string
required

The UUID of the entity.

version
integer<int64>

The version number:

  • Create: On initial Create to insert a new entity, the version is set at 1 in the response.
  • Update: On successful Update, the version is incremented by 1 in the response.
name
string

The name of the Resource Group.

dtCreated
string<date-time>

The date and time (in ISO-8601 format) when the Resource Group was created.

dtLastModified
string<date-time>

The date and time (in ISO-8601 format) when the Resource Group was last modified.

createdBy
string

The unique identifier (UUID) of the user who created this Resource Group.

lastModifiedBy
string

The unique identifier (UUID) of the user who last modified this Resource Group.