@arcxp/cli v1.0.0
@arcxp/cli
The Arc XP CLI is your command center for automating workflows to accelerate development and simplify engineering workflows.
Requirements
- Node.js v20 or later is required to run this project.
Options
--enable-debug-logs
Enable logging for environment loading
-V, --version
output the version number
Subcommands
arcxp ifx
Interact directly with the IFX APIs using the command line. Follow the guide to get started: https://dev.arcxp.com/integrations/ifx-cli/
Subcommands
arcxp ifx integrationsarcxp ifx secretsarcxp ifx custom-eventsarcxp ifx webhooksarcxp ifx logsarcxp ifx bundlesarcxp ifx event-subscriptions
arcxp ifx integrations
Subcommands
arcxp ifx integrations listarcxp ifx integrations viewarcxp ifx integrations createarcxp ifx integrations updatearcxp ifx integrations delete
arcxp ifx integrations list
View a detailed list of all integrations.
Usage
arcxp ifx integrations list [options]Options
-p, --page <page>
Page number, used with pageSize for paginating the list
-s, --pageSize <pageSize>
Number of items per page
arcxp ifx integrations view
View an integration's details and status.
Usage
arcxp ifx integrations view [options]Options
-n, --name <name>
Name of integration to view
arcxp ifx integrations create
Create a new integration.
Usage
arcxp ifx integrations create [options]Options
-n, --name <name>
Name of new integration
-d, --description <description>
Give it a description
-e, --email <email>
Email for receiving alerts
arcxp ifx integrations update
Update an existing integration.
Usage
arcxp ifx integrations update [options]Options
-n, --name <name>
Name of integration to update
-d, --description [description]
Updated description (optional)
-e, --email [email]
Email for receiving alerts (optional)
-s --enabled <enabled>
Enable (true) or disable (false) the integration
arcxp ifx integrations delete
Deletes an existing integration and all associated resources (except your Github repo).
Usage
arcxp ifx integrations delete [options]Options
-n, --name <name>
Name of integration to delete (cannot be undone)
arcxp ifx secrets
Subcommands
arcxp ifx secrets list
Lists secret names for an integration.
Usage
arcxp ifx secrets list [options]Options
-n, --integrationName <integrationName>
Name of integration to list secrets
arcxp ifx secrets create
Add a new secret to an integration.
Usage
arcxp ifx secrets create [options]Options
-n, --integrationName <integrationName>
Name of integration where the secret will be used
-s, --secretName <secretName>
Secret name to be referenced in your code
-v, --secretValue <secretValue>
The value of the secret
arcxp ifx secrets update
Update an existing secret.
Usage
arcxp ifx secrets update [options]Options
-n, --integrationName <integrationName>
Name of integration
-s, --secretName <secretName>
Name of secret to be updated
-v, --secretValue <secretValue>
The new value of the secret
arcxp ifx custom-events
Subcommands
arcxp ifx custom-events listarcxp ifx custom-events registerarcxp ifx custom-events updatearcxp ifx custom-events delete-eventarcxp ifx custom-events delete-event-schedule
arcxp ifx custom-events list
View your organization's existing custom events.
Usage
arcxp ifx custom-events list [options]Options
-p, --page <page>
Page number, used with pageSize for paginating the list
-s, --pageSize <pageSize>
Number of items per page
arcxp ifx custom-events register
Register a custom event for your organization to be used on a schedule or with a webhook.
Usage
arcxp ifx custom-events register [options]Options
-e, --eventName <eventName>
Name the event e.g. custom:schedule_report
-d, --description <description>
Describe what the event will be used for
-s, --schedule [schedule]
6-field cron string e.g. 0 12 ? * WED * (optional)
arcxp ifx custom-events update
Update description and/or schedule of an existing custom event.
Usage
arcxp ifx custom-events update [options]Options
-e, --eventName <eventName>
The custom event name to be updated
-d, --description [description]
Updated description (optional)
-s, --schedule [schedule]
6-field cron string e.g. 0 12 ? * WED * (optional)
arcxp ifx custom-events delete-event
Delete a custom event. The event must not have any active subscriptions. Note this action cannot be undone, but you can recreate the event if needed.
Usage
arcxp ifx custom-events delete-event [options]Options
-e, --eventName <eventName>
Name of event to delete (cannot be undone)
arcxp ifx custom-events delete-event-schedule
Delete an event's schedule without deleting the event itself. This action cannot be undone, but the schedule can be added back to the event.
Usage
arcxp ifx custom-events delete-event-schedule [options]Options
-e, --eventName <eventName>
Name of event whose schedule to delete
arcxp ifx webhooks
Subcommands
arcxp ifx webhooks listarcxp ifx webhooks registerarcxp ifx webhooks updatearcxp ifx webhooks deletearcxp ifx webhooks trigger
arcxp ifx webhooks list
View your organization's existing webhooks.
Usage
arcxp ifx webhooks list [options]Options
-p, --page <page>
Page number, used with pageSize for paginating the list
-s, --pageSize <pageSize>
Number of items per page
arcxp ifx webhooks register
Once you have created a custom event, register a webhook to receive the request for that event.
Usage
arcxp ifx webhooks register [options]Options
-e, --eventName <eventName>
Name of event you want linked to your webhook
-d, --description <description>
Describe what the webhook will do
arcxp ifx webhooks update
Update the description for a webhook.
Usage
arcxp ifx webhooks update [options]Options
-e, --eventName <eventName>
Name of event you want linked to your webhook
-d, --description <description>
Updated description (optional)
arcxp ifx webhooks delete
Remove a webhook for an event. Note this action cannot be undone! If you need to recreate this webhook, a new UUID will be issued.
Usage
arcxp ifx webhooks delete [options]Options
-e, --eventName <eventName>
Name of event associated with the webhook
arcxp ifx webhooks trigger
Triggers a webhook by its UUID.
Usage
arcxp ifx webhooks trigger [options]Options
-u, --uuid <uuid>
The UUID of the webhook to trigger
-p, --payload <payload>
JSON-formatted custom payload
arcxp ifx logs
Subcommands
arcxp ifx logs search
View log search results.
Usage
arcxp ifx logs search [options]Options
-n, --name <name>
Integration name to search
-q, --query [search query]
Optional keywords to search for in logs
-s, --startDateTime [YYYY-MM-DD HH:MM:SS]
START timestamp in format YYYY-MM-DD HH:MM:SS, default 300s ago
-e, --endDateTime [YYYY-MM-DD HH:MM:SS]
END timestamp in format YYYY-MM-DD HH:MM:SS, default 'now'
arcxp ifx bundles
Subcommands
arcxp ifx bundles listarcxp ifx bundles uploadarcxp ifx bundles deployarcxp ifx bundles promotearcxp ifx bundles download
arcxp ifx bundles list
Get a list of all uploaded bundles for an integration.
Usage
arcxp ifx bundles list [options]Options
-n, --name <name>
Integration name to list bundles
arcxp ifx bundles upload
Upload a zipped bundle for an integration.
Usage
arcxp ifx bundles upload [options]Options
-n, --integrationName <integrationName>
Integration name for bundle upload
-b, --bundleName <bundleName>
Provide a unique bundle name
-p, --bundlePath <bundlePath>
Local path to the zipped bundle
arcxp ifx bundles deploy
Deploy an uploaded bundle so that it can be promoted to live.
Usage
arcxp ifx bundles deploy [options]Options
-n, --name <name>
Name of integration
-b, --bundleName <bundleName>
Name of bundle to deploy
arcxp ifx bundles promote
Promote a specific bundle version to live. Any traffic after the promotion will go to the newly promoted bundle.
Usage
arcxp ifx bundles promote [options]Options
-n, --name <name>
Name of integration
-v, --versionNumber <versionNumber>
Bundle version to promote to live
arcxp ifx bundles download
Promote a specific bundle version to live. Any traffic after the promotion will go to the newly promoted bundle.
Usage
arcxp ifx bundles download [options]Options
-n, --name <name>
Name of integration
-b --bundleName <bundleName>
Name of bundle to download
-o --outputFilePath <outputFilePath>
Local file path including filename to save the zip e.g. /Users/me/zips/somename.zip
arcxp ifx event-subscriptions
Subcommands
arcxp ifx event-subscriptions listarcxp ifx event-subscriptions createarcxp ifx event-subscriptions update
arcxp ifx event-subscriptions list
List all event subscriptions.
Usage
arcxp ifx event-subscriptions list [options]arcxp ifx event-subscriptions create
Subscribe to an event so that your integration will be invoked when the event is received.
Usage
arcxp ifx event-subscriptions create [options]Options
-n, --name <name>
Name of integration that will be triggered for this event
-e, --eventName <eventName>
Name of event you are subscribing to
-s, --enabled [enabled]
Enable (true) or disable (false) the subscription
arcxp ifx event-subscriptions update
Manage an existing event subscription
Usage
arcxp ifx event-subscriptions update [options]Options
-n, --name <name>
Integration name associated with the event
-e, --eventName <eventName>
Event name to update
-s, --enabled <enabled>
Enable (true) or disable (false) the subscription