Integrations

Integrations connect Moonshadow to external tools such as Slack, GitHub, and Jira. Use these endpoints to discover which providers are available, connect them to your workspace, and manage their configuration and lifecycle.

---

List Available Integrations

Returns all integration providers that you can connect to a workspace.

curl https://api.moonshadow.dev/v1/integrations \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

data · array

Array of available integration providers.

data[].provider · string

Provider key: slack, github, jira, notion, etc.

data[].name · string

Human-readable provider name.

data[].description · string

Short description of what the integration does.

data[].required_credentials · array

List of credential fields required to connect, such as token, api_key, or oauth.

{
  "data": [
    {
      "provider": "slack",
      "name": "Slack",
      "description": "Send channel notifications and trigger workflows from Slack messages.",
      "required_credentials": ["token"]
    },
    {
      "provider": "github",
      "name": "GitHub",
      "description": "Sync issues, pull requests, and repository events into Moonshadow.",
      "required_credentials": ["token"]
    },
    {
      "provider": "jira",
      "name": "Jira",
      "description": "Create and track Jira issues directly from Moonshadow workflows.",
      "required_credentials": ["api_key", "domain"]
    }
  ]
}

---

Connect an Integration

Connects an external provider to a workspace.

curl -X POST https://api.moonshadow.dev/v1/integrations/connect \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "slack",
    "workspace_id": "ws_abc123",
    "credentials": {
      "token": "xoxb-your-slack-bot-token"
    }
  }'

Request Body

provider · string · required

Provider key from the available integrations list, e.g. slack or github.

workspace_id · string · required

The workspace ID to connect the integration to.

credentials · object · required

Provider-specific credentials. Fields match required_credentials from the available integrations list.

Response

{
  "integration_id": "int_ghi789",
  "provider": "slack",
  "workspace_id": "ws_abc123",
  "status": "connected",
  "connected_at": "2024-06-10T17:45:00Z"
}

Store credentials securely and rotate them regularly. Moonshadow encrypts credentials at rest, but leaked tokens can still be used against the third-party provider.

---

List Connected Integrations

Returns all integrations currently connected to a workspace.

curl https://api.moonshadow.dev/v1/workspaces/ws_abc123/integrations \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

id · string · required

The workspace ID.

Response

{
  "data": [
    {
      "integration_id": "int_ghi789",
      "provider": "slack",
      "status": "connected",
      "connected_at": "2024-06-10T17:45:00Z",
      "last_synced_at": "2024-06-10T18:00:00Z"
    },
    {
      "integration_id": "int_jkl012",
      "provider": "github",
      "status": "error",
      "connected_at": "2024-05-01T12:00:00Z",
      "last_synced_at": "2024-05-15T09:30:00Z"
    }
  ]
}

data[].status · string

Current connection status: connected, disconnected, or error.

data[].last_synced_at · string | null

ISO 8601 timestamp of the last successful data sync, or null if never synced.

---

Disconnect an Integration

Removes an integration from a workspace and deletes stored credentials.

curl -X DELETE https://api.moonshadow.dev/v1/workspaces/ws_abc123/integrations/int_ghi789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

id · string · required

The workspace ID.

integrationId · string · required

The integration ID to disconnect.

Response

Returns 204 No Content on success.

Disconnecting an integration stops all event ingestion from that provider and removes associated webhooks. You can reconnect later without losing workspace configuration.