# Meshes API

Meshes API for event ingestion, connections, rules, and workspace management.

Version: 1.0.0

## Servers

```
https://api.meshes.io
```

## Security

### bearerAuth

Machine / server-side authentication using a Bearer token (JWT).

Type: http
Scheme: bearer
Bearer Format: JWT

### publishableKey

Publishable workspace key for client-side event ingestion. Safe to expose in frontend code. Used only for emitting /events endpoints and does not grant access to management APIs.

Type: apiKey
In: header
Name: X-Meshes-Publishable-Key

## Download OpenAPI description

[Meshes API](https://docs.meshes.dev/_bundle/openapi.yaml)

## Connections

Connection related end-points

### Get Connections

 - [GET /api/v1/connections](https://docs.meshes.dev/openapi/connections/getconnections.md): Get all connections for the organization

### Create Connection

 - [POST /api/v1/connections](https://docs.meshes.dev/openapi/connections/createconnection.md): Create a New Connection

### Get Connection

 - [GET /api/v1/connections/{connection_id}](https://docs.meshes.dev/openapi/connections/getconnection.md): Get Connection by ID

### Update Connection

 - [PUT /api/v1/connections/{connection_id}](https://docs.meshes.dev/openapi/connections/updateconnection.md): Update Connection by ID

### Delete Connection

 - [DELETE /api/v1/connections/{connection_id}](https://docs.meshes.dev/openapi/connections/deleteconnection.md): Delete Connection by ID

### Get Connection Actions

 - [GET /api/v1/connections/{connection_id}/actions](https://docs.meshes.dev/openapi/connections/getconnectionactions.md): Get Connection Actions by ID

### Get Connection Fields

 - [GET /api/v1/connections/{connection_id}/fields](https://docs.meshes.dev/openapi/connections/getconnectionfields.md): Get Connection Fields by Connection ID

### Get Connection Default Mappings

 - [GET /api/v1/connections/{connection_id}/mappings/default](https://docs.meshes.dev/openapi/connections/getconnectiondefaultmappings.md): Get Connection Default Mappings by Connection ID

### Update Connection Default Mappings

 - [PUT /api/v1/connections/{connection_id}/mappings/default](https://docs.meshes.dev/openapi/connections/updateconnectiondefaultmappings.md): Update Connection Default Mappings by Connection ID

## Events

Event related end-points

### Get Events

 - [GET /api/v1/events](https://docs.meshes.dev/openapi/events/getevents.md): Get all events for the organization

### Create Event

 - [POST /api/v1/events](https://docs.meshes.dev/openapi/events/createevent.md): Create (emit) a single event

### Create Bulk Events

 - [POST /api/v1/events/bulk](https://docs.meshes.dev/openapi/events/createbulkevent.md): Create (emit) multiple events up to 100 at a time

### Get Event

 - [GET /api/v1/events/{event_id}](https://docs.meshes.dev/openapi/events/getevent.md): Get Event by ID

### Get Event with Payload

 - [GET /api/v1/events/{event_id}/payload](https://docs.meshes.dev/openapi/events/geteventpayload.md): Get Event by ID and include the payload

### Retry Event

 - [POST /api/v1/events/{event_id}/rules/{rule_id}/retry](https://docs.meshes.dev/openapi/events/retryeventrule.md): Retry a single event rule

## Integrations

Integration related end-points

### Get Integrations

 - [GET /api/v1/integrations](https://docs.meshes.dev/openapi/integrations/getintegrations.md): Get the possible integrations metadata

## Rules

Rule related end-points

### Get Rules

 - [GET /api/v1/rules](https://docs.meshes.dev/openapi/rules/getrules.md): Get all rules for the organization

### Create Rule

 - [POST /api/v1/rules](https://docs.meshes.dev/openapi/rules/createrule.md): Create a new rule

### Get Rule

 - [GET /api/v1/rules/{rule_id}](https://docs.meshes.dev/openapi/rules/getrule.md): Get Rule by ID

### Delete Rule

 - [DELETE /api/v1/rules/{rule_id}](https://docs.meshes.dev/openapi/rules/deleterule.md): Delete Rule by ID

## Workspaces

Workspace related end-points

### Get Workspaces

 - [GET /api/v1/workspaces](https://docs.meshes.dev/openapi/workspaces/getworkspaces.md): Get all workspaces for the organization

### Create Workspace

 - [POST /api/v1/workspaces](https://docs.meshes.dev/openapi/workspaces/createworkspace.md): Create a New Workspace

### Get Workspace

 - [GET /api/v1/workspaces/{workspace_id}](https://docs.meshes.dev/openapi/workspaces/getworkspace.md): Get Workspace by ID

### Update Workspace

 - [PUT /api/v1/workspaces/{workspace_id}](https://docs.meshes.dev/openapi/workspaces/updateworkspace.md): Update Workspace by ID

### Get Workspace Connections

 - [GET /api/v1/workspaces/{workspace_id}/connections](https://docs.meshes.dev/openapi/workspaces/getworkspaceconnections.md): Get all connections for the workspace

### Get Workspace Rules

 - [GET /api/v1/workspaces/{workspace_id}/rules](https://docs.meshes.dev/openapi/workspaces/getworkspacerules.md): Get all rules for the workspace

### Get Workspace Events

 - [GET /api/v1/workspaces/{workspace_id}/events](https://docs.meshes.dev/openapi/workspaces/getworkspaceevents.md): Get all events for the workspace