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

# Record an admission event

> Appends one event to the admission's audit trail. The event id is server-generated; `at` defaults to now and `by` to the authenticated operator.



## OpenAPI

````yaml api-reference/doc-tool/ipd-api/ipd-sdk-openapi.json post /ipd/v1/sdk/admissions/{admission_id}/events
openapi: 3.1.0
info:
  title: Eka IPD Admission API
  version: '1.0'
servers:
  - description: Production
    url: https://api.eka.care
  - description: Stage/Sandbox
    url: https://api.dev.eka.care
security: []
paths:
  /ipd/v1/sdk/admissions/{admission_id}/events:
    post:
      tags:
        - IPD API
      summary: Record an admission event
      description: >-
        Appends one event to the admission's audit trail. The event id is
        server-generated; `at` defaults to now and `by` to the authenticated
        operator.
      operationId: IpdSdkRecordAnAdmissionEvent
      parameters:
        - name: auth
          in: header
          required: true
          schema:
            type: string
          example: >-
            eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiX2lkIjoiMTIzNDU2IiwiY2xpZW50X2lkIjoiNzg5MCIsImV4dHJhX2ZpZWxkIjoiZXh0cmFfZmllbGRfZGF0YSJ9.q9KzBI6f4l3OyM_EkB5Quq0l9EEMFh5JS-fx3F_PHUM
        - schema:
            minLength: 1
            type: string
          in: path
          name: admission_id
          required: true
          description: Id of the IPD admission.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              additionalProperties: false
              type: object
              required:
                - kind
              properties:
                kind:
                  description: Event kind.
                  anyOf:
                    - type: string
                      enum:
                        - ADMISSION
                    - type: string
                      enum:
                        - STATUS
                    - type: string
                      enum:
                        - STATUS_CHANGE
                    - type: string
                      enum:
                        - CLEARANCE
                    - type: string
                      enum:
                        - DISCHARGE_STEP
                    - type: string
                      enum:
                        - DISCHARGE_SUMMARY
                    - type: string
                      enum:
                        - PHARMACY_NOTIFY
                at:
                  description: When it happened (ISO date-time); defaults to now.
                  type: string
                by:
                  description: >-
                    Actor recorded on the change; defaults to the authenticated
                    operator.
                  additionalProperties: true
                  type: object
                  required:
                    - id
                  properties:
                    id:
                      minLength: 1
                      type: string
                    name:
                      type: string
                    role:
                      type: string
                from:
                  anyOf:
                    - type: string
                    - type: 'null'
                to:
                  type: string
                meta:
                  additionalProperties: true
                  description: Kind-specific details.
                  type: object
                  properties: {}
                notes:
                  type: string
                clearance_type:
                  type: string
                note:
                  type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                required:
                  - id
                  - at
                  - kind
                properties:
                  id:
                    type: string
                  at:
                    description: When the event happened (ISO date-time).
                    type: string
                  kind:
                    description: Event kind, for example `STATUS_CHANGE` or `CLEARANCE`.
                    type: string
                  by:
                    description: Who acted.
                    anyOf:
                      - description: >-
                          Actor recorded on the change; defaults to the
                          authenticated operator.
                        additionalProperties: true
                        type: object
                        required:
                          - id
                        properties:
                          id:
                            minLength: 1
                            type: string
                          name:
                            type: string
                          role:
                            type: string
                      - type: string
                  from:
                    anyOf:
                      - type: string
                      - type: 'null'
                  to:
                    type: string
                  meta:
                    additionalProperties: true
                    description: Kind-specific details.
                    type: object
                    properties: {}
                  notes:
                    type: string
                  clearance_type:
                    type: string
                  note:
                    type: string
        '400':
          description: Bad Request — the request failed validation or was rejected.
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string
        '404':
          description: >-
            Not Found — the admission (or the addressed record) does not exist
            in your workspace.
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                properties:
                  message:
                    type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.