---
title: "Replace action completely"
method: PUT
path: "/actions/{selector}"
tags: ["Actions"]
---

# Replace action completely

`PUT /actions/{selector}`

## Path parameters

- `selector` string, required

## Query parameters

- `layer` 'universal' | 'integration' | 'connection'
- `integrationKey` string
- `integrationId` string
- `connectionId` string
- `connectionKey` string
- `instanceKey` string

## Request body

- CreateAction
  - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
  - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
  - `name` string — Display name. Optional on create; used to generate key when key is omitted.
  - `description` string — Optional human-readable description.
  - `meta` object — Optional key-value metadata.
  - `integrationId` string — Internal ID of the integration this element belongs to. Omit for universal elements; set for integration-specific elements. Uniqueness of key is scoped per integration.
  - `integrationUuid` string — UUID of the integration; alternative to integrationId when creating from export. Resolved to integrationId by the API.
  - `integrationKey` string — Key of the integration; alternative to integrationId. Resolved to integrationId by the API.
  - `parentId` string — Internal ID of the parent workspace element. Used for hierarchy (e.g. integration-level under universal). Child key uniqueness is scoped by parent and integration.
  - `parentUuid` string — UUID of the parent element; alternative to parentId when creating (e.g. from export). Resolved to parentId by the API.
  - `parentKey` string — Key of the parent element; alternative to parentId. Resolved to parentId by the API.
  - `connectionId` string — Connection ID for filtering or for connection-level instances. Same semantics as base integration-level property.
  - `instanceKey` string — Key for the connection-level instance when multiple exist per connection. Same semantics as base integration-level property.
  - `isUniversal` boolean — When true, the element is universal (shared across all integrations). Requires universal-element access. Omit or false for integration-specific elements.
  - `externalAppId` string — Internal ID of the external app this element belongs to. Auto-populated from the integration when integrationId is set and the integration has an externalAppId.
  - `externalAppUuid` string — UUID of the external app; alternative to externalAppId when creating from export. Resolved to externalAppId by the API.
  - `externalAppKey` string — Key of the external app; alternative to externalAppId. Resolved to externalAppId by the API.
  - `inputSchema` CreateActionSchema0
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` CreateActionSchema0 — recursive
    - `additionalProperties` union
      - boolean
      - CreateActionSchema0 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` CreateActionSchema0[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `type` 'list-data-records' | 'find-data-record-by-id' | 'match-data-record' | 'create-data-record' | 'find-or-create-data-record' | 'update-data-record' | 'delete-data-record' | 'search-data-record' | 'connector-operation' | 'api-request-to-external-app' | 'api-request-to-your-app' | 'http-request' | 'run-javascript' | 'api-request' — Action type (e.g. ConnectorOperation, RunJavascript). Determines which handler runs and which config schema is used for validation.
  - `config` object — Type-specific configuration object. Validated by the handler's config schema; passed to handler setup/run and getTemplateOutputSchema.
  - `outputMapping` unknown
  - `customOutputSchema` CreateActionSchema0
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` CreateActionSchema0 — recursive
    - `additionalProperties` union
      - boolean
      - CreateActionSchema0 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` CreateActionSchema0[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `intent` string — [Experimental] Intent-based instruction for an agent to configure this element.

## Response `200`

- ActionApiResponse
  - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
  - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
  - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
  - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
  - `description` string — Optional human-readable description.
  - `meta` object — Optional key-value metadata.
  - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
  - `errors` ActionApiResponseSchema0[] — Validation or setup errors when state is not READY.
    - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
    - `key` string
    - `message` string, required
    - `data` object
    - `stack` object
    - `causedByError` ActionApiResponseSchema0 — recursive
    - `logs` object[]
  - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
  - `createdAt` string — ISO date when the element was created.
  - `updatedAt` string — ISO date when the element was last updated.
  - `archivedAt` string — When set, the element is archived (soft-deleted). Archived elements cannot be patched.
  - `isDeactivated` boolean — When true, setup is skipped and the element is treated as inactive (e.g. when dependencies are deactivated or the element is archived).
  - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
  - `integrationId` string — Internal ID of the integration this element belongs to. Omit for universal elements; set for integration-specific elements. Uniqueness of key is scoped per integration.
  - `integrationUuid` string — UUID of the integration; alternative to integrationId when creating from export. Resolved to integrationId by the API.
  - `integrationKey` string — Key of the integration; alternative to integrationId. Resolved to integrationId by the API.
  - `parentId` string — Internal ID of the parent workspace element. Used for hierarchy (e.g. integration-level under universal). Child key uniqueness is scoped by parent and integration.
  - `parentUuid` string — UUID of the parent element; alternative to parentId when creating (e.g. from export). Resolved to parentId by the API.
  - `parentKey` string — Key of the parent element; alternative to parentId. Resolved to parentId by the API.
  - `connectionId` string — Connection ID for filtering or for connection-level instances. Same semantics as base integration-level property.
  - `instanceKey` string — Key for the connection-level instance when multiple exist per connection. Same semantics as base integration-level property.
  - `isUniversal` boolean — When true, the element is universal (shared across all integrations). Requires universal-element access. Omit or false for integration-specific elements.
  - `externalAppId` string — Internal ID of the external app this element belongs to. Auto-populated from the integration when integrationId is set and the integration has an externalAppId.
  - `externalAppUuid` string — UUID of the external app when this action is published in a package that has an external app. Populated in API responses for published actions.
  - `externalAppKey` string — Key of the external app; alternative to externalAppId. Resolved to externalAppId by the API.
  - `inputSchema` ActionApiResponseSchema1
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` ActionApiResponseSchema1 — recursive
    - `additionalProperties` union
      - boolean
      - ActionApiResponseSchema1 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` ActionApiResponseSchema1[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `type` 'list-data-records' | 'find-data-record-by-id' | 'match-data-record' | 'create-data-record' | 'find-or-create-data-record' | 'update-data-record' | 'delete-data-record' | 'search-data-record' | 'connector-operation' | 'api-request-to-external-app' | 'api-request-to-your-app' | 'http-request' | 'run-javascript' | 'api-request' — Action type (e.g. ConnectorOperation, RunJavascript). Determines which handler runs and which config schema is used for validation.
  - `config` object — Type-specific configuration object. Validated by the handler's config schema; passed to handler setup/run and getTemplateOutputSchema.
  - `outputMapping` unknown
  - `customOutputSchema` ActionApiResponseSchema1
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` ActionApiResponseSchema1 — recursive
    - `additionalProperties` union
      - boolean
      - ActionApiResponseSchema1 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` ActionApiResponseSchema1[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `isCustomized` boolean
  - `userId` string
  - `tenantId` string
  - `universalParentId` string — For connection-level instances: ID of the universal (root) action in the hierarchy. Set automatically when creating an instance; used in list/selector queries to filter by universal parent.
  - `outputSchema` ActionApiResponseSchema1
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` ActionApiResponseSchema1 — recursive
    - `additionalProperties` union
      - boolean
      - ActionApiResponseSchema1 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` ActionApiResponseSchema1[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `isPublic` boolean — When true, the element is publicly listed (e.g. in universe). Used for published packages; publish/unpublish updates this on published elements.
  - `integration` object
    - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
    - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
    - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
    - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
    - `description` string — Optional human-readable description.
    - `meta` object — Optional key-value metadata.
    - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
    - `errors` ActionApiResponseSchema0[] — Validation or setup errors when state is not READY.
      - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
      - `key` string
      - `message` string, required
      - `data` object
      - `stack` object
      - `causedByError` ActionApiResponseSchema0 — recursive
      - `logs` object[]
    - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
    - `createdAt` string — ISO date when the element was created.
    - `updatedAt` string — ISO date when the element was last updated.
    - `archivedAt` string
    - `isDeactivated` boolean
    - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
    - `logoUri` string, required
    - `connectorId` string
    - `connectorVersion` string
    - `oAuthCallbackUri` string
    - `parameters` object
    - `hasMissingParameters` boolean
    - `hasDocumentation` boolean
    - `hasOperations` boolean
    - `operationsCount` number
    - `hasData` boolean
    - `dataCollectionsCount` number
    - `hasEvents` boolean
    - `eventsCount` number
    - `hasGlobalWebhooks` boolean
    - `hasUdm` boolean
    - `isTest` boolean
    - `externalAppId` string
    - `authType` 'integration-app-token' | 'membrane-token' | 'oauth2' | 'oauth1' | 'client-credentials' | 'proxy'
    - `optionsConfig` object
  - `user` object
    - `id` string, required
    - `name` string, required
    - `meta` object
    - `internalId` string, required
    - `fields` object
    - `credentials` object
    - `lastActiveAt` string
    - `isTest` boolean
    - `isBillable` boolean
    - `isActive` boolean
    - `aiCreditsRolling30DayLimit` number, nullable
    - `createdAt` string
    - `archivedAt` string
  - `parent` object
    - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
    - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
    - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
    - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
    - `description` string — Optional human-readable description.
    - `meta` object — Optional key-value metadata.
    - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
    - `errors` ActionApiResponseSchema0[] — Validation or setup errors when state is not READY.
      - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
      - `key` string
      - `message` string, required
      - `data` object
      - `stack` object
      - `causedByError` ActionApiResponseSchema0 — recursive
      - `logs` object[]
    - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
    - `createdAt` string — ISO date when the element was created.
    - `updatedAt` string — ISO date when the element was last updated.
    - `archivedAt` string — When set, the element is archived (soft-deleted). Archived elements cannot be patched.
    - `isDeactivated` boolean — When true, setup is skipped and the element is treated as inactive (e.g. when dependencies are deactivated or the element is archived).
    - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
    - `integrationId` string — Internal ID of the integration this element belongs to. Omit for universal elements; set for integration-specific elements. Uniqueness of key is scoped per integration.
    - `integrationUuid` string — UUID of the integration; alternative to integrationId when creating from export. Resolved to integrationId by the API.
    - `integrationKey` string — Key of the integration; alternative to integrationId. Resolved to integrationId by the API.
    - `parentId` string — Internal ID of the parent workspace element. Used for hierarchy (e.g. integration-level under universal). Child key uniqueness is scoped by parent and integration.
    - `parentUuid` string — UUID of the parent element; alternative to parentId when creating (e.g. from export). Resolved to parentId by the API.
    - `parentKey` string — Key of the parent element; alternative to parentId. Resolved to parentId by the API.
    - `connectionId` string — Connection ID for filtering or for connection-level instances. Same semantics as base integration-level property.
    - `instanceKey` string — Key for the connection-level instance when multiple exist per connection. Same semantics as base integration-level property.
    - `isUniversal` boolean — When true, the element is universal (shared across all integrations). Requires universal-element access. Omit or false for integration-specific elements.
    - `externalAppId` string — Internal ID of the external app this element belongs to. Auto-populated from the integration when integrationId is set and the integration has an externalAppId.
    - `externalAppUuid` string — UUID of the external app when this action is published in a package that has an external app. Populated in API responses for published actions.
    - `externalAppKey` string — Key of the external app; alternative to externalAppId. Resolved to externalAppId by the API.
    - `inputSchema` ActionApiResponseSchema1
      - `title` string
      - `description` string
      - `type` union
        - string
        - string[]
      - `format` string
      - `properties` object
      - `items` ActionApiResponseSchema1 — recursive
      - `additionalProperties` union
        - boolean
        - ActionApiResponseSchema1 — recursive
      - `enum` union[]
        - union
          - string
          - number
      - `referenceRecords` object[]
      - `referenceCollection` object
        - `key` object
        - `parameters` object
      - `referenceUdm` string
      - `default` object
      - `allowCustom` boolean
      - `$ref` string
      - `required` string[]
      - `minLength` number
      - `maxLength` number
      - `minimum` number
      - `maximum` number
      - `maxItems` number
      - `readOnly` boolean
      - `writeOnly` boolean
      - `examples` object[]
      - `anyOf` ActionApiResponseSchema1[]
      - `isImplied` boolean
      - `isSensitive` boolean
      - `referenceCollectionPath` string
      - `referenceCollectionUri` string
    - `type` 'list-data-records' | 'find-data-record-by-id' | 'match-data-record' | 'create-data-record' | 'find-or-create-data-record' | 'update-data-record' | 'delete-data-record' | 'search-data-record' | 'connector-operation' | 'api-request-to-external-app' | 'api-request-to-your-app' | 'http-request' | 'run-javascript' | 'api-request' — Action type (e.g. ConnectorOperation, RunJavascript). Determines which handler runs and which config schema is used for validation.
    - `config` object — Type-specific configuration object. Validated by the handler's config schema; passed to handler setup/run and getTemplateOutputSchema.
    - `outputMapping` unknown
    - `customOutputSchema` ActionApiResponseSchema1
      - `title` string
      - `description` string
      - `type` union
        - string
        - string[]
      - `format` string
      - `properties` object
      - `items` ActionApiResponseSchema1 — recursive
      - `additionalProperties` union
        - boolean
        - ActionApiResponseSchema1 — recursive
      - `enum` union[]
        - union
          - string
          - number
      - `referenceRecords` object[]
      - `referenceCollection` object
        - `key` object
        - `parameters` object
      - `referenceUdm` string
      - `default` object
      - `allowCustom` boolean
      - `$ref` string
      - `required` string[]
      - `minLength` number
      - `maxLength` number
      - `minimum` number
      - `maximum` number
      - `maxItems` number
      - `readOnly` boolean
      - `writeOnly` boolean
      - `examples` object[]
      - `anyOf` ActionApiResponseSchema1[]
      - `isImplied` boolean
      - `isSensitive` boolean
      - `referenceCollectionPath` string
      - `referenceCollectionUri` string
    - `isCustomized` boolean
    - `userId` string
    - `tenantId` string
    - `universalParentId` string — For connection-level instances: ID of the universal (root) action in the hierarchy. Set automatically when creating an instance; used in list/selector queries to filter by universal parent.
    - `outputSchema` unknown
    - `isPublic` boolean — When true, the element is publicly listed (e.g. in universe). Used for published packages; publish/unpublish updates this on published elements.
  - `appliedToIntegrations` object[]
    - `element` object, required
      - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
      - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
      - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
      - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
      - `description` string — Optional human-readable description.
      - `meta` object — Optional key-value metadata.
      - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
      - `errors` ActionApiResponseSchema0[] — Validation or setup errors when state is not READY.
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` ActionApiResponseSchema0 — recursive
        - `logs` object[]
      - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
      - `createdAt` string — ISO date when the element was created.
      - `updatedAt` string — ISO date when the element was last updated.
      - `archivedAt` string — When set, the element is archived (soft-deleted). Archived elements cannot be patched.
      - `isDeactivated` boolean — When true, setup is skipped and the element is treated as inactive (e.g. when dependencies are deactivated or the element is archived).
      - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
      - `integrationId` string — Internal ID of the integration this element belongs to. Omit for universal elements; set for integration-specific elements. Uniqueness of key is scoped per integration.
      - `integrationUuid` string — UUID of the integration; alternative to integrationId when creating from export. Resolved to integrationId by the API.
      - `integrationKey` string — Key of the integration; alternative to integrationId. Resolved to integrationId by the API.
      - `parentId` string — Internal ID of the parent workspace element. Used for hierarchy (e.g. integration-level under universal). Child key uniqueness is scoped by parent and integration.
      - `parentUuid` string — UUID of the parent element; alternative to parentId when creating (e.g. from export). Resolved to parentId by the API.
      - `parentKey` string — Key of the parent element; alternative to parentId. Resolved to parentId by the API.
      - `connectionId` string — Connection ID for filtering or for connection-level instances. Same semantics as base integration-level property.
      - `instanceKey` string — Key for the connection-level instance when multiple exist per connection. Same semantics as base integration-level property.
      - `isUniversal` boolean — When true, the element is universal (shared across all integrations). Requires universal-element access. Omit or false for integration-specific elements.
      - `externalAppId` string — Internal ID of the external app this element belongs to. Auto-populated from the integration when integrationId is set and the integration has an externalAppId.
      - `externalAppUuid` string — UUID of the external app when this action is published in a package that has an external app. Populated in API responses for published actions.
      - `externalAppKey` string — Key of the external app; alternative to externalAppId. Resolved to externalAppId by the API.
      - `inputSchema` ActionApiResponseSchema1
        - `title` string
        - `description` string
        - `type` union
          - string
          - string[]
        - `format` string
        - `properties` object
        - `items` ActionApiResponseSchema1 — recursive
        - `additionalProperties` union
          - boolean
          - ActionApiResponseSchema1 — recursive
        - `enum` union[]
          - union
            - string
            - number
        - `referenceRecords` object[]
        - `referenceCollection` object
          - `key` object
          - `parameters` object
        - `referenceUdm` string
        - `default` object
        - `allowCustom` boolean
        - `$ref` string
        - `required` string[]
        - `minLength` number
        - `maxLength` number
        - `minimum` number
        - `maximum` number
        - `maxItems` number
        - `readOnly` boolean
        - `writeOnly` boolean
        - `examples` object[]
        - `anyOf` ActionApiResponseSchema1[]
        - `isImplied` boolean
        - `isSensitive` boolean
        - `referenceCollectionPath` string
        - `referenceCollectionUri` string
      - `type` 'list-data-records' | 'find-data-record-by-id' | 'match-data-record' | 'create-data-record' | 'find-or-create-data-record' | 'update-data-record' | 'delete-data-record' | 'search-data-record' | 'connector-operation' | 'api-request-to-external-app' | 'api-request-to-your-app' | 'http-request' | 'run-javascript' | 'api-request' — Action type (e.g. ConnectorOperation, RunJavascript). Determines which handler runs and which config schema is used for validation.
      - `config` object — Type-specific configuration object. Validated by the handler's config schema; passed to handler setup/run and getTemplateOutputSchema.
      - `outputMapping` unknown
      - `customOutputSchema` ActionApiResponseSchema1
        - `title` string
        - `description` string
        - `type` union
          - string
          - string[]
        - `format` string
        - `properties` object
        - `items` ActionApiResponseSchema1 — recursive
        - `additionalProperties` union
          - boolean
          - ActionApiResponseSchema1 — recursive
        - `enum` union[]
          - union
            - string
            - number
        - `referenceRecords` object[]
        - `referenceCollection` object
          - `key` object
          - `parameters` object
        - `referenceUdm` string
        - `default` object
        - `allowCustom` boolean
        - `$ref` string
        - `required` string[]
        - `minLength` number
        - `maxLength` number
        - `minimum` number
        - `maximum` number
        - `maxItems` number
        - `readOnly` boolean
        - `writeOnly` boolean
        - `examples` object[]
        - `anyOf` ActionApiResponseSchema1[]
        - `isImplied` boolean
        - `isSensitive` boolean
        - `referenceCollectionPath` string
        - `referenceCollectionUri` string
      - `isCustomized` boolean
      - `userId` string
      - `tenantId` string
      - `universalParentId` string — For connection-level instances: ID of the universal (root) action in the hierarchy. Set automatically when creating an instance; used in list/selector queries to filter by universal parent.
      - `outputSchema` unknown
      - `isPublic` boolean — When true, the element is publicly listed (e.g. in universe). Used for published packages; publish/unpublish updates this on published elements.
    - `integration` object, required
      - `id` string, required — Internal database ID of the element. Assigned by the API; unique per element.
      - `name` string, required — Display name. Always present in API responses (filled by API if not set on create).
      - `uuid` string — Stable unique identifier (UUID). Can be provided on create; otherwise generated. Must be unique across elements of this type.
      - `key` string — Stable key for referencing the element (e.g. in selectors). Unique per (parent, integration) scope. Generated from name if not provided on create.
      - `description` string — Optional human-readable description.
      - `meta` object — Optional key-value metadata.
      - `state` 'BUILDING' | 'CLIENT_ACTION_REQUIRED' | 'CONFIGURATION_ERROR' | 'SETUP_FAILED' | 'READY' | 'DISCONNECTING' — Current lifecycle or health state (e.g. READY, SETUP_FAILED, CONFIGURATION_ERROR, BUILDING). Set by the engine during setup and validation.
      - `errors` ActionApiResponseSchema0[] — Validation or setup errors when state is not READY.
        - `type` 'bad_request' | 'connection' | 'configuration' | 'dependency_error' | 'flow_run' | 'flow_instance_setup' | 'concurrency' | 'internal' | 'action_run' | 'action_instance_setup' | 'unit_run' | 'custom_code' | 'insufficient_credit' | 'openrouter_not_configured'
        - `key` string
        - `message` string, required
        - `data` object
        - `stack` object
        - `causedByError` ActionApiResponseSchema0 — recursive
        - `logs` object[]
      - `revision` string — Opaque revision token; changes on each update. Used for optimistic concurrency.
      - `createdAt` string — ISO date when the element was created.
      - `updatedAt` string — ISO date when the element was last updated.
      - `archivedAt` string
      - `isDeactivated` boolean
      - `isReadOnly` boolean — When true, the element cannot be modified (e.g. published package elements or elements from another workspace).
      - `logoUri` string, required
      - `connectorId` string
      - `connectorVersion` string
      - `oAuthCallbackUri` string
      - `parameters` object
      - `hasMissingParameters` boolean
      - `hasDocumentation` boolean
      - `hasOperations` boolean
      - `operationsCount` number
      - `hasData` boolean
      - `dataCollectionsCount` number
      - `hasEvents` boolean
      - `eventsCount` number
      - `hasGlobalWebhooks` boolean
      - `hasUdm` boolean
      - `isTest` boolean
      - `externalAppId` string
      - `authType` 'integration-app-token' | 'membrane-token' | 'oauth2' | 'oauth1' | 'client-credentials' | 'proxy'
      - `optionsConfig` object
  - `defaultOutputSchema` ActionApiResponseSchema1
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` ActionApiResponseSchema1 — recursive
    - `additionalProperties` union
      - boolean
      - ActionApiResponseSchema1 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` ActionApiResponseSchema1[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `transformedOutputSchema` ActionApiResponseSchema1
    - `title` string
    - `description` string
    - `type` union
      - string
      - string[]
    - `format` string
    - `properties` object
    - `items` ActionApiResponseSchema1 — recursive
    - `additionalProperties` union
      - boolean
      - ActionApiResponseSchema1 — recursive
    - `enum` union[]
      - union
        - string
        - number
    - `referenceRecords` object[]
    - `referenceCollection` object
      - `key` object
      - `parameters` object
    - `referenceUdm` string
    - `default` object
    - `allowCustom` boolean
    - `$ref` string
    - `required` string[]
    - `minLength` number
    - `maxLength` number
    - `minimum` number
    - `maximum` number
    - `maxItems` number
    - `readOnly` boolean
    - `writeOnly` boolean
    - `examples` object[]
    - `anyOf` ActionApiResponseSchema1[]
    - `isImplied` boolean
    - `isSensitive` boolean
    - `referenceCollectionPath` string
    - `referenceCollectionUri` string
  - `dependencies` object[]

---

[API](https://skmtc.net/integration/apis/membrane-api.md) · [All operations](https://skmtc.net/integration/apis/membrane-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/integration/membrane-api/versions/1db9c5a3d78c/schema)