Upsert Plugin Request

POST /plugins

Creates a new plugin

Requires a signed user/session or the existing authenticated client flow. The anonymous DCR delegated device profile cannot invoke this operation.

Required scope

Any authenticated access token

pluginWebsocketPlugin | HttpPlugin | WebservicePlugin | ApplePushNotificationPlugin | HostedComputePlugin: discriminator: type
applePushNotificationSecretApplePushNotificationSecret: APNS authentication token secret (required when creating an APPLE_PUSH_NOTIFICATION plugin with new credentials)
secretReferenceIdstring: Reference to an existing secret in the secret store (use instead of inline credentials when the secret already exists)

Plugin created successfully

idstringRequired

The created plugin ID

pattern: "^port1/[^/]+/[^/]+/plugins/[^/]+$"

400

Invalid request payload

Check the request fields and any validation details, then correct the payload.

500

Internal server error

Retry with backoff only when the operation is safe to repeat. Include the error code when reporting persistent failures.