> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorules.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Upsert test event

> Create a new test event or update an existing one if a matching ID is provided.



## OpenAPI

````yaml /openapi/brms.json patch /api/projects/{projectId}/test-events
openapi: 3.0.3
info:
  title: GoRules BRMS
  version: local
servers: []
security: []
tags:
  - name: AI
    description: >-
      AI-powered assistant for interactive conversations and decision logic
      generation
  - name: Audit log
    description: Track and export organisation activity logs for compliance and monitoring
  - name: Branches
    description: >-
      Manage feature branches for collaborative decision development with
      commits and merging
  - name: Change requests
    description: Review and approve changes before merging or deploying to environments
  - name: Cloud
    description: Cloud-specific endpoints for organisation and client management
  - name: Decision
    description: Evaluate and simulate decision graphs with trace and performance data
  - name: Deployment workflows
    description: Manage deployment workflow runs and job approvals
  - name: Deployments
    description: Configure cloud storage providers for release deployments
  - name: Document
    description: Manage decision documents, versions, and file operations within projects
  - name: Environment
    description: >-
      Configure deployment environments with approval workflows and access
      tokens
  - name: Group
    description: Manage permission groups for project-level access control
  - name: Infrastructure
    description: Health check and infrastructure status endpoints
  - name: Integration
    description: Configure external integrations for HTTP requests and data sources
  - name: Invitation
    description: Manage organisation invitations for new members
  - name: Member
    description: Manage project membership and group assignments
  - name: Organisation
    description: Manage organisation settings, preferences, and licensing
  - name: Personal access token
    description: Create and manage personal access tokens for API authentication
  - name: Profile
    description: Manage current user profile settings
  - name: Project
    description: Create and manage projects with approval workflows
  - name: Release
    description: >-
      Package, version, and deploy decision documents. Learn more about
      [Releases](https://gorules.io/developers/brms/multi-environment)
  - name: Roles
    description: Define custom roles with permissions for organisation-wide access control
  - name: Security
    description: Manage project access tokens for API authentication
  - name: Templates
    description: Browse and apply project templates for quick onboarding
  - name: Test events
    description: Manage test events for decision evaluation and testing
  - name: User
    description: Manage organisation users, invitations, and service accounts
paths:
  /api/projects/{projectId}/test-events:
    patch:
      tags:
        - Test events
      summary: Upsert test event
      description: >-
        Create a new test event or update an existing one if a matching ID is
        provided.
      operationId: upsertTestEvent
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: projectId
          required: true
          description: ID of the project containing the test event
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                testEvent:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                    name:
                      type: string
                    context:
                      type: string
                    category:
                      type: string
                      enum:
                        - private
                        - shared
                        - global
                    userId:
                      type: string
                      nullable: true
                      format: uuid
                    documentId:
                      type: string
                      nullable: true
                      format: uuid
                  required:
                    - id
                    - name
                    - context
                    - category
                  description: Test event data to create or update
              required:
                - testEvent
        required: true
      responses:
        '200':
          description: The created or updated test event
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier of the test event
                  name:
                    type: string
                    description: Name of the test event
                  context:
                    type: string
                    description: JSON context data for the test event
                  category:
                    type: string
                    enum:
                      - private
                      - shared
                      - global
                    description: Category of the test event (private, shared, or global)
                  projectId:
                    type: string
                    format: uuid
                    description: ID of the project this test event belongs to
                  userId:
                    type: string
                    nullable: true
                    format: uuid
                    description: >-
                      ID of the user who owns this test event (for private
                      events)
                  documentId:
                    type: string
                    nullable: true
                    format: uuid
                    description: ID of the document this test event is associated with
                required:
                  - id
                  - name
                  - context
                  - category
                  - projectId
                description: The created or updated test event

````