---
updatedAt: 2026-06-12T14:47:10.000Z
agentTools:
  projectIndex: https://docs.formant.io/llms.txt
---

# Post

Create a new intervention response.
Resource: interventions
Authorized roles: viewer

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "NotificationMuted": {
        "properties": {
          "start": {
            "format": "date-time",
            "type": "string",
            "description": "Mute start time (inclusive)."
          },
          "end": {
            "format": "date-time",
            "type": "string",
            "description": "Mute end time (exclusive)."
          }
        },
        "type": "object",
        "required": [
          "start",
          "end"
        ],
        "nullable": true
      },
      "InterventionResponse": {
        "properties": {
          "interventionType": {
            "type": "string",
            "enum": [
              "selection",
              "labeling",
              "teleop",
              "physical"
            ],
            "description": "Type of intervention to which you are responding."
          },
          "type": {
            "type": "string",
            "enum": [
              "triggered-event",
              "datapoint-event",
              "device-online",
              "device-offline",
              "intervention-request",
              "intervention-response",
              "teleop-session-record",
              "port-forwarding-session-record",
              "command-request",
              "command-response",
              "command-delivery",
              "custom",
              "comment",
              "system",
              "annotation",
              "task-summary",
              "stateful"
            ]
          },
          "data": {
            "description": "Body of your response to the intevention."
          },
          "interventionId": {
            "format": "uuid",
            "type": "string",
            "description": "ID of the intervention request to which you are responding."
          },
          "userId": {
            "format": "uuid",
            "type": "string",
            "description": "ID of the user who is responding to an intervention request."
          },
          "id": {
            "format": "uuid",
            "type": "string"
          },
          "createdAt": {
            "format": "date-time",
            "type": "string"
          },
          "updatedAt": {
            "format": "date-time",
            "type": "string"
          },
          "tags": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "organizationId": {
            "format": "uuid",
            "type": "string",
            "description": "ID of the organization in which to create this new event."
          },
          "externalId": {
            "type": "string",
            "nullable": true,
            "description": "External ID of this event."
          },
          "time": {
            "format": "date-time",
            "type": "string",
            "description": "Start time of the data range relevant to this event."
          },
          "endTime": {
            "format": "date-time",
            "type": "string",
            "nullable": true,
            "description": "End time of the data range relevant to this event."
          },
          "parentId": {
            "format": "uuid",
            "type": "string",
            "nullable": true,
            "description": "If this custom event is related to another event, you can add the ID of that parent event here."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "User-customizable metadata associated with this event in key-value pair format."
          },
          "message": {
            "maxLength": 1024,
            "type": "string",
            "description": "Message of this event. Must match the `message` field in the Formant UI when configuring a custom event."
          },
          "viewed": {
            "type": "boolean"
          },
          "deviceId": {
            "format": "uuid",
            "type": "string",
            "nullable": true,
            "description": "ID of the device relevant to this event."
          },
          "streamName": {
            "type": "string",
            "nullable": true
          },
          "streamType": {
            "type": "string",
            "enum": [
              "bitset",
              "localization",
              "point cloud",
              "location",
              "file",
              "health",
              "transform tree",
              "battery",
              "video",
              "numeric set",
              "json",
              "image",
              "numeric",
              "text"
            ],
            "nullable": true
          },
          "eventTriggerId": {
            "format": "uuid",
            "type": "string",
            "nullable": true
          },
          "notificationEnabled": {
            "type": "boolean",
            "description": "Set this to `true` to enable notifications for this event."
          },
          "notificationMuted": {
            "$ref": "#/components/schemas/NotificationMuted",
            "nullable": true,
            "description": "Set this to temporarily mute notifications for this event."
          },
          "deletedAt": {
            "nullable": true,
            "format": "date-time",
            "type": "string"
          }
        },
        "type": "object",
        "required": [
          "interventionType",
          "data",
          "interventionId",
          "time"
        ]
      },
      "CreateInterventionResponse": {
        "properties": {
          "interventionType": {
            "type": "string",
            "enum": [
              "selection",
              "labeling",
              "teleop",
              "physical"
            ],
            "description": "Type of intervention to which you are responding."
          },
          "type": {
            "type": "string",
            "enum": [
              "intervention-response"
            ],
            "description": "Enter `intervention-response`."
          },
          "tags": {
            "description": "Tags to associate with the intervention response."
          },
          "time": {
            "description": "Timestamp of the intervention response."
          },
          "message": {
            "description": "Message to associate with the intervention response."
          },
          "deviceId": {
            "description": "ID of the device relevant to this intervention."
          },
          "data": {
            "description": "Body of your response to the intevention."
          },
          "interventionId": {
            "format": "uuid",
            "type": "string",
            "description": "ID of the intervention request to which you are responding."
          },
          "userId": {
            "format": "uuid",
            "type": "string",
            "description": "ID of the user who is responding to this intervention request."
          }
        },
        "type": "object",
        "required": [
          "interventionType",
          "data",
          "interventionId"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "info": {
    "title": "Formant admin-api",
    "version": "1.357.8"
  },
  "openapi": "3.0.0",
  "paths": {
    "/intervention-responses": {
      "post": {
        "operationId": "InterventionResponseController.post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInterventionResponse"
              }
            }
          },
          "description": "CreateInterventionResponse",
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionResponse"
                }
              }
            },
            "description": ""
          }
        },
        "summary": "Post",
        "tags": [
          "Intervention Response"
        ],
        "description": "Create a new intervention response.\nResource: interventions\nAuthorized roles: viewer",
        "security": [
          {
            "bearerAuth": []
          }
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.formant.io/v1/admin"
    }
  ]
}
```