Integration Instance Groups

Create integration instance group session template

Creates or updates the shared session template for a specific integration instance group.

post/integration-instance-groups/{integration_instance_group_id}/session-template

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Path parameters

integration_instance_group_idstring required

Unique identifier of the integration instance group.

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Request body

namestring
descriptionstring
metadataobject

Response

Successful response

object'session.template' required

String representing the object's type

idstring required

Unique session template identifier

status'active' | 'archived' | 'deleted' required

Status of the session template

namestring required

Template name

descriptionstring nullable required

Template description

metadataobject nullable required

Custom key-value pairs

integration_instance_idstring nullable required
integration_instance_group_idstring nullable required
identity_actor_idstring nullable required
identity_idstring nullable required
created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "id": "stm_2bCdEfGhJkLmNpQr",
  "name": "Production Template",
  "description": "Template for production sessions",
  "providers": [
    {
      "id": "stp_3cDeFgHjKlMnPqRs",
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "session_template_id": "stm_2bCdEfGhJkLmNpQr",
      "deployment": {
        "id": "pde_1aBcDeFgHjKlMnPq",
        "name": "Production",
        "description": "Production deployment",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      },
      "config": {
        "id": "pcf_7dEfGhJkLmNpQrSt",
        "name": "Production Config",
        "description": "Configuration for production environment",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      },
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    }
  ],
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.