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

# Execute Connector Action

> Execute a connector action



## OpenAPI

````yaml post /connectors/{connectorId}/actions/{actionId}/execute
openapi: 3.0.1
info:
  title: Connectivity API
  description: >
    The Alloy Connectivity API enables you to create and manage MCP (Model
    Context Protocol) servers that provide secure, controlled access to platform
    integrations for AI assistants.
  version: '1.0'
  contact:
    name: Alloy Support
    email: support@runalloy.com
    url: https://runalloy.com
servers:
  - url: https://production.runalloy.com
    description: Production server
security: []
tags:
  - name: Connectors
    description: Get connector details and execute actions
  - name: Credentials
    description: Manage credentials for connectors
  - name: Files
    description: Manage file uploads and downloads
  - name: Users
    description: Manage users
paths:
  /connectors/{connectorId}/actions/{actionId}/execute:
    post:
      tags:
        - Connectors
      summary: Execute Connector Action
      description: Execute a connector action
      operationId: execute-connector-action
      parameters:
        - name: x-api-version
          in: header
          required: true
          description: API version
          schema:
            type: string
            default: 2025-09
          example: 2025-09
        - name: x-alloy-userid
          in: header
          required: false
          description: >-
            The ID of the user executing the action; If not provided, the
            request will be made as the API Key user
          schema:
            type: string
          example: 68b666094a6821e749c36006
        - name: connectorId
          in: path
          required: true
          description: Connector ID
          schema:
            type: string
          example: slack
        - name: actionId
          in: path
          required: true
          description: Action ID
          schema:
            type: string
          example: chat_postMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExecuteConnectorActionRequest'
      responses:
        '200':
          description: Action executed successfully
          content:
            application/json:
              example:
                success: true
                result:
                  messageId: '1234567890'
      security:
        - bearerAuth: []
components:
  schemas:
    ExecuteConnectorActionRequest:
      type: object
      required:
        - credentialId
      properties:
        credentialId:
          type: string
          description: Valid credential ID (must be a valid ObjectId)
          example: 507f1f77bcf86cd799439011
        requestBody:
          type: object
          additionalProperties: true
          description: Request body data for the action
        additionalHeaders:
          type: object
          additionalProperties: true
          description: Additional headers to include in the request
        queryParameters:
          type: object
          additionalProperties: true
          description: Query parameters for the request
        pathParams:
          type: object
          additionalProperties: true
          description: Path parameters for the request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Bearer

````