---
title: "Post organization events"
method: POST
path: "/v1/orgs/{org_slug}/events/"
tags: ["events"]
---

# Post organization events

`POST /v1/orgs/{org_slug}/events/`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Send events directly to Socket.

Authentication: Organization API token only.
Required token scopes: *

## Path parameters

- `org_slug` string, required

## Request body

- object[]: Array of event payloads
  - `action` string
  - `alert_action` string
  - `alert_count` number
  - `api_error` string
  - `artifact_purl` string
  - `block_reason` string
  - `block_source` string
  - `blocked_alert_count` number
  - `cached` boolean
  - `client_action` string
  - `client_ip` string
  - `decision` string
  - `event_category` string
  - `event_id` string
  - `event_kind` string
  - `event_sender_created_at` string
  - `event_type` string
  - `ignore_reason` string
  - `input_purl` string
  - `machine_id` string
  - `monitor_reason` string
  - `parser_name` string
  - `parser_version` string
  - `private_registry_request_id` string
  - `purlCheckLatencyMs` number
  - `purl_check_latency_ms` number
  - `registryFqdn` string
  - `repo` string
  - `request_id` string
  - `response_code` number
  - `socket_api_response_code` number
  - `socket_client_version` string
  - `source_path` string
  - `stale` boolean
  - `trace_id` string
  - `upstream_host` string
  - `upstream_path` string
  - `upstream_status` number
  - `user_agent` string
  - `versions` object
  - `warn_reason` string

## Response `200`

Events ingestion metadata

- object: Events ingestion metadata

## Other responses

- `201`: Events ingestion metadata
- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `413`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/socket-dev/apis/socket-api-v1.md) - [All operations](https://skmtc.dev/socket-dev/apis/socket-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/socket-dev/apis/socket-api-v1/revisions/e88284728ffb?raw)