These commands are generated from the Ligantic OpenAPI spec, so the CLI covers every public API operation. The hand-written commands in the CLI command reference take precedence where both exist: for example records list is hand-written, and records json-patch is generated. Find a command with ligantic cli search "<what you want to do>".
Every generated command follows the same conventions:
--space <id>.<schemaId> also accepts a Schema name.flowVersionId → --flow-version-id). Boolean flags take an optional true/false, repeatable values take several arguments, and fields marked JSON take a JSON value.--data <json|@file|-> — the whole request body as inline JSON, a file, or stdin. Field flags override the matching keys. Fields marked required must be set by a flag or in --data.--dry-run — print the request (method, url, query, body) instead of sending it. Secret-named fields (such as password or clientSecret) are shown as [REDACTED].--yes — destructive operations fail with exit code 2 unless --yes is passed. On a terminal in table mode they ask for confirmation instead.{ "ok": true }.ligantic spacesManage Spaces and the current Space
ligantic spaces secrets delete [options]Delete a Space secret.
Option | Description |
|---|---|
| path (required) |
ligantic spaces secrets list [options]List a Space's secrets (paths only, never values).
Option | Description |
|---|---|
| path |
| recursive |
ligantic spaces auth-strategies create [options]Create a Space authentication strategy.
Option | Description |
|---|---|
| type (required) One of: |
| name (required) |
| default space role id |
| success redirect experience id |
| failure redirect experience id |
| logout redirect experience id |
| jwks url |
| issuer |
| audience |
| client id claim |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces auth-strategies delete [options] <spaceAuthenticationStrategyId>Delete a Space authentication strategy.
Argument | Description |
|---|---|
| The space authentication strategy id |
ligantic spaces auth-strategies list [options]List a Space's authentication strategies.
ligantic spaces auth-strategies show [options] <spaceAuthenticationStrategyId>Get a Space authentication strategy.
Argument | Description |
|---|---|
| The space authentication strategy id |
ligantic spaces auth-strategies update [options] <spaceAuthenticationStrategyId>Update a Space authentication strategy.
Argument | Description |
|---|---|
| The space authentication strategy id |
Option | Description |
|---|---|
| name (required) |
| default space role id |
| success redirect experience id |
| failure redirect experience id |
| logout redirect experience id |
| jwks url |
| issuer |
| audience |
| client id claim |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces create [options]Create a Space.
Option | Description |
|---|---|
| title (required) |
| parent space id |
| organisation id |
| organisation billing account id |
| clone from space id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces delete [options]Delete a Space.
ligantic spaces domains create [options]Add a custom domain to a Space.
Option | Description |
|---|---|
| domain (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces domains delete [options] <domainId>Remove a custom domain from a Space.
Argument | Description |
|---|---|
| The domain id |
ligantic spaces domains list [options]List a Space's custom domains.
ligantic spaces domains set-primary [options]Set a Space's primary domain.
Option | Description |
|---|---|
| domain id (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces domains show [options] <domainId>Get a Space custom domain.
Argument | Description |
|---|---|
| The domain id |
ligantic spaces export [options]Export Schemas, Flows, Experiences, and other resources from a Space.
Option | Description |
|---|---|
| schema ids |
| flow ids |
| experience ids |
| space role ids |
| space authentication strategy ids |
| oauth credential ids |
| sql credential ids |
| folder ids |
| endpoint ids |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces identities create [options]Create a Space identity.
Option | Description |
|---|---|
| space authentication strategy id (required) |
| space role id (required) |
| display name |
| external identifier |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces identities delete [options] <spaceIdentityId>Remove an identity from a Space.
Argument | Description |
|---|---|
| The space identity id |
ligantic spaces identities list [options]List a Space's identities.
ligantic spaces identities set-role [options] <spaceIdentityId>Change a Space identity's role.
Argument | Description |
|---|---|
| The space identity id |
Option | Description |
|---|---|
| role One of: |
| space role id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces identities show [options] <userId>Get a user's identity in a Space.
Argument | Description |
|---|---|
| The user id |
ligantic spaces import [options]Import an export into a Space.
Option | Description |
|---|---|
| flows (required; JSON) |
| schemas (required; JSON) |
| experiences (required; JSON) |
| space roles (required; JSON) |
| space authentication strategies (JSON) |
| space oauth credentials (JSON) |
| space sql credentials (JSON) |
| folders (JSON) |
| artifacts (JSON) |
| canvases (JSON) |
| canvas system (JSON) |
| endpoints (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces invites accept [options] <inviteId>Accept a Space invite.
Argument | Description |
|---|---|
| The invite id |
ligantic spaces invites cancel [options] <inviteId>Cancel a pending Space invite.
Argument | Description |
|---|---|
| The invite id |
ligantic spaces invites create [options]Invite a user to a Space by email.
Option | Description |
|---|---|
| email (required) |
| role One of: |
| space role id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces invites decline [options] <inviteId>Decline a Space invite.
Argument | Description |
|---|---|
| The invite id |
ligantic spaces invites list [options]List a Space's invites.
ligantic spaces invites pending [options]List your pending Space invites.
ligantic spaces invites pending-by-space [options]List your pending invites to a Space.
ligantic spaces invites set-role [options] <inviteId>Change the role of a pending Space invite.
Argument | Description |
|---|---|
| The invite id |
Option | Description |
|---|---|
| role One of: |
| space role id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces oauth-credentials create [options]Create a Space OAuth credential.
Option | Description |
|---|---|
| name (required) |
| endpoint source One of: |
| issuer endpoint |
| authorization endpoint |
| token endpoint |
| client authentication method One of: |
| client id (required) |
| client secret path (required) |
| scopes |
| refresh period days |
| grant type One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces oauth-credentials delete [options] <oauthCredentialId>Delete a Space OAuth credential.
Argument | Description |
|---|---|
| The oauth credential id |
ligantic spaces oauth-credentials list [options]List a Space's OAuth credentials.
ligantic spaces oauth-credentials revoke [options] <oauthCredentialId>Revoke a Space OAuth credential's tokens.
Argument | Description |
|---|---|
| The oauth credential id |
ligantic spaces oauth-credentials show [options] <oauthCredentialId>Get a Space OAuth credential.
Argument | Description |
|---|---|
| The oauth credential id |
ligantic spaces oauth-credentials update [options] <oauthCredentialId>Update a Space OAuth credential.
Argument | Description |
|---|---|
| The oauth credential id |
Option | Description |
|---|---|
| name |
| issuer endpoint |
| authorization endpoint |
| token endpoint |
| client authentication method (JSON) |
| client id |
| client secret path |
| scopes |
| refresh period days |
| endpoint source One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces roles create [options]Create a Space role.
Option | Description |
|---|---|
| name (required) |
| capabilities (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces roles delete [options] <spaceRoleId>Delete a Space role.
Argument | Description |
|---|---|
| The space role id |
Option | Description |
|---|---|
| transfer space role id |
ligantic spaces roles list [options]List a Space's roles.
ligantic spaces roles show [options] <spaceRoleId>Get a Space role.
Argument | Description |
|---|---|
| The space role id |
ligantic spaces roles update [options] <spaceRoleId>Update a Space role.
Argument | Description |
|---|---|
| The space role id |
Option | Description |
|---|---|
| name (required) |
| capabilities (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces set-billing-mode [options]Change how a Space is billed.
Option | Description |
|---|---|
| billing mode (required) One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces set-billing-user [options]Make yourself the billing user of a Space.
ligantic spaces set-name [options]Change a Space's name (its URL slug).
Option | Description |
|---|---|
| name |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces set-parent [options]Move a Space under another parent Space.
Option | Description |
|---|---|
| parent space id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces set-title [options]Change a Space's title.
Option | Description |
|---|---|
| title (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic spaces users list [options]List the Ligantic users with access to a Space.
ligantic schemasManage Schemas
ligantic schemas config [options] <schemaId>Get the field configuration of a Schema's current version.
GET /spaces/{spaceId}/schemas/{schemaId}/config
Argument | Description |
|---|---|
| The Schema (id or name) |
ligantic schemas create [options]Create a Schema.
POST /spaces/{spaceId}/schemas
Option | Description |
|---|---|
| name (required) |
| display name template (required) |
| auto save (server default: false) |
| schema (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas delete [options] <schemaId>Delete a Schema.
DELETE /spaces/{spaceId}/schemas/{schemaId} — destructive, requires --yes
Argument | Description |
|---|---|
| The Schema (id or name) |
ligantic schemas fields add [options] <schemaId>Add a field to a Schema.
Adds one field without sending the whole Schema, and returns its generated id. parent nests it inside an object field (or an array of objects).
POST /spaces/{spaceId}/schemas/{schemaId}/fields
Argument | Description |
|---|---|
| The Schema (id or name) |
Option | Description |
|---|---|
| The field, such as |
| The object field to add it to, by id, name, or dot path (the top level by default) |
| The field's id, the key of its value in Record data (generated by default) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas fields delete [options] <schemaId> <field>Remove a field from a Schema.
Existing Records keep any value stored under the field's id, but it is no longer part of the Schema.
DELETE /spaces/{spaceId}/schemas/{schemaId}/fields/{field} — destructive, requires --yes
Argument | Description |
|---|---|
| The Schema (id or name) |
| The field (id, name, or dot path such as address.city) |
ligantic schemas fields update [options] <schemaId> <field>Change one field of a Schema.
Merges changes into the field, such as {"required":true} or {"name":"Email address"}. A null value removes a property.
PATCH /spaces/{spaceId}/schemas/{schemaId}/fields/{field}
Argument | Description |
|---|---|
| The Schema (id or name) |
| The field (id, name, or dot path such as address.city) |
Option | Description |
|---|---|
| Field properties to set (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas relationships create [options]Create a relationship between two Schemas.
POST /spaces/{spaceId}/schemas-relationships
Option | Description |
|---|---|
| name (required) |
| from name |
| from schema version id (required) |
| to schema version id (required) |
| directional (required) |
| multiple from (required) |
| multiple to (required) |
| from show in table (server default: false) |
| to show in table (server default: false) |
| from display mode (server default: "list") One of: |
| to display mode (server default: "list") One of: |
| from schema path |
| to schema path |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas relationships delete [options] <schemaRelationshipVersionId>Delete a Schema relationship.
DELETE /spaces/{spaceId}/schemas-relationships/{schemaRelationshipVersionId} — destructive, requires --yes
Argument | Description |
|---|---|
| The schema relationship version id |
ligantic schemas relationships reorder [options]Reorder the relationships shown on a Schema version.
PATCH /spaces/{spaceId}/schemas-relationships/order
Option | Description |
|---|---|
| schema version id (required) |
| schema relationship version ids (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas relationships update [options] <schemaRelationshipVersionId>Update a Schema relationship.
PATCH /spaces/{spaceId}/schemas-relationships/{schemaRelationshipVersionId}
Argument | Description |
|---|---|
| The schema relationship version id |
Option | Description |
|---|---|
| name (required) |
| from name |
| from schema version id (required) |
| to schema version id (required) |
| directional (required) |
| multiple from (required) |
| multiple to (required) |
| from show in table (server default: false) |
| to show in table (server default: false) |
| from display mode (server default: "list") One of: |
| to display mode (server default: "list") One of: |
| from schema path |
| to schema path |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic schemas update [options] <schemaId>Update a Schema's name, display template, or fields.
PATCH /spaces/{spaceId}/schemas/{schemaId}
Argument | Description |
|---|---|
| The Schema (id or name) |
Option | Description |
|---|---|
| Omit it to keep the current display name template |
| auto save |
| schema (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic recordsWork with Records
ligantic records confirm-uploads [options] <schemaId> <entityId>Confirm a Record's file uploads finished, so its create or update Flows run.
POST /spaces/{spaceId}/schemas/{schemaId}/entities/{entityId}/confirm-uploads-complete
Argument | Description |
|---|---|
| The Schema (id or name) |
| The Record id |
Option | Description |
|---|---|
| action (required) One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic records json-patch [options] <schemaId> <entityId>Apply RFC 6902 JSON Patch operations to a Record's data.
PATCH /spaces/{spaceId}/schemas/{schemaId}/entities/{entityId}/json-patch
Argument | Description |
|---|---|
| The Schema (id or name) |
| The Record id |
Option | Description |
|---|---|
| operations (required; JSON) |
| has pending uploads (server default: false) |
| name based (server default: false) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic records update-link [options] <schemaRelationshipVersionId> <entityRelationshipId>Change the Records a relationship link connects.
PATCH /spaces/{spaceId}/schemas-relationships/{schemaRelationshipVersionId}/entities/{entityRelationshipId}
Argument | Description |
|---|---|
| The schema relationship version id |
| The entity relationship id |
Option | Description |
|---|---|
| from id (required) |
| to id (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flowsWork with Flows
ligantic flows runs cancel [options] <flowId> <executionId>Cancel a Flow run.
POST /spaces/{spaceId}/flows/{flowId}/executions/{executionId}/cancel — destructive, requires --yes
Argument | Description |
|---|---|
| The flow id |
| The Flow run id |
ligantic flows runs confirm-uploads [options] <flowId> <executionId>Confirm a Flow run's file uploads finished, so the run can start.
POST /spaces/{spaceId}/flows/{flowId}/executions/{executionId}/confirm-uploads-complete
Argument | Description |
|---|---|
| The flow id |
| The Flow run id |
ligantic flows runs list [options] <flowId>List a Flow's runs.
GET /spaces/{spaceId}/flows/{flowId}/executions
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| limit (server default: 10) |
| offset (server default: 0) |
ligantic flows clone [options] <flowId>Clone a Flow.
POST /spaces/{spaceId}/flows/{flowId}/clone
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| flow version id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows create [options]Create a Flow.
POST /spaces/{spaceId}/flows
Option | Description |
|---|---|
| name (required) |
| The whole graph. Omit nodes and edges to start with one |
| edges (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows delete [options] <flowId>Delete a Flow.
DELETE /spaces/{spaceId}/flows/{flowId} — destructive, requires --yes
Argument | Description |
|---|---|
| The flow id |
ligantic flows edges add [options] <flowId>Connect two nodes of a Flow.
Connects an output handle of source to an input handle of target; flows nodes list shows each node's handle ids. Node and edge edits change the Flow's draft version; when the latest version is published, a new draft is created from it first. Publish with flows versions publish.
POST /spaces/{spaceId}/flows/{flowId}/edges
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| The nodeId the edge starts from (required) |
| An output handle id of the source node (required) |
| The nodeId the edge goes to (required) |
| An input handle id of the target node (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows edges delete [options] <flowId> <edgeId>Remove an edge from a Flow.
Node and edge edits change the Flow's draft version; when the latest version is published, a new draft is created from it first. Publish with flows versions publish.
DELETE /spaces/{spaceId}/flows/{flowId}/edges/{edgeId} — destructive, requires --yes
Argument | Description |
|---|---|
| The flow id |
| The edge id |
ligantic flows list-by-schema [options] <schemaId>List the Flows attached to a Schema.
GET /spaces/{spaceId}/flows/by-schema/{schemaId}
Argument | Description |
|---|---|
| The Schema (id or name) |
Option | Description |
|---|---|
| show on entity (server default: false) |
| show on table (server default: false) |
ligantic flows node-types list [options]List the Flow node types.
GET /flow-node-types
ligantic flows node-types show [options] <nodeType>Describe the configuration a Flow node type accepts.
Returns the node's data properties and their types, for flows nodes add --node-data.
GET /flow-node-types/{nodeType}
Argument | Description |
|---|---|
| The node type |
ligantic flows nodes add [options] <flowId>Add a node to a Flow.
Returns the new node's id and its handles, ready to connect with flows edges add. Node and edge edits change the Flow's draft version; when the latest version is published, a new draft is created from it first. Publish with flows versions publish.
POST /spaces/{spaceId}/flows/{flowId}/nodes
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| type (required) One of: |
| The node's configuration (its |
| Canvas position (below the lowest node by default) (JSON) |
| The node's id within the Flow, used by edges (generated by default) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows nodes delete [options] <flowId> <nodeId>Remove a node, and its edges, from a Flow.
Node and edge edits change the Flow's draft version; when the latest version is published, a new draft is created from it first. Publish with flows versions publish.
DELETE /spaces/{spaceId}/flows/{flowId}/nodes/{nodeId} — destructive, requires --yes
Argument | Description |
|---|---|
| The flow id |
| The node's nodeId within the Flow |
ligantic flows nodes list [options] <flowId>List a Flow's nodes, their handles, and edges.
Returns the latest version's graph: each node's id, type, label, and the handle ids to connect edges to, plus every edge. Use flows nodes show for a node's full configuration.
GET /spaces/{spaceId}/flows/{flowId}/nodes
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| flow version id |
ligantic flows nodes show [options] <flowId> <nodeId>Get one node of a Flow with its handles and edges.
GET /spaces/{spaceId}/flows/{flowId}/nodes/{nodeId}
Argument | Description |
|---|---|
| The flow id |
| The node's nodeId within the Flow |
Option | Description |
|---|---|
| flow version id |
ligantic flows nodes update [options] <flowId> <nodeId>Change one node of a Flow.
Merges data into the node's configuration. Node and edge edits change the Flow's draft version; when the latest version is published, a new draft is created from it first. Publish with flows versions publish.
PATCH /spaces/{spaceId}/flows/{flowId}/nodes/{nodeId}
Argument | Description |
|---|---|
| The flow id |
| The node's nodeId within the Flow |
Option | Description |
|---|---|
| Configuration to merge into the node's |
| position (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows versions create [options] <flowId>Add a new version to a Flow.
POST /spaces/{spaceId}/flows/{flowId}/versions
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| name (required) |
| default log level One of: |
| nodes (required; JSON) |
| edges (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows versions publish [options] <flowId> <flowVersionId>Publish a Flow version.
POST /spaces/{spaceId}/flows/{flowId}/versions/{flowVersionId}/publish
Argument | Description |
|---|---|
| The flow id |
| The flow version id |
ligantic flows versions run [options] <flowId> <flowVersionId>Run a specific Flow version.
POST /spaces/{spaceId}/flows/{flowId}/versions/{flowVersionId}/execute
Argument | Description |
|---|---|
| The flow id |
| The flow version id |
Option | Description |
|---|---|
| trigger node id |
| inputs (JSON) |
| has pending upload files (server default: false) |
| log level One of: |
| scheduled at |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic flows versions show [options] <flowId>Get a Flow version (the latest published version by default).
GET /spaces/{spaceId}/flows/{flowId}/versions
Argument | Description |
|---|---|
| The flow id |
Option | Description |
|---|---|
| flow version id |
ligantic flows versions update [options] <flowId> <flowVersionId>Update a draft Flow version.
Replaces the version's nodes and edges. Only draft versions can be changed; create a new version with flows versions create to change a published one.
PATCH /spaces/{spaceId}/flows/{flowId}/versions/{flowVersionId}
Argument | Description |
|---|---|
| The flow id |
| The flow version id |
Option | Description |
|---|---|
| name (required) |
| default log level One of: |
| nodes (required; JSON) |
| edges (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic billingYour credit balance and usage
ligantic billing credits list [options]List your credit grants and how much of each is used.
GET /billing/credits
ligantic billing credits usages [options] <creditId>List the usage recorded against one of your credit grants.
GET /billing/credits/{creditId}/usages
Argument | Description |
|---|---|
| The credit id |
Option | Description |
|---|---|
| offset (server default: 0) |
| limit (server default: 10) |
ligantic endpointsManage a Space's API endpoints
ligantic endpoints create [options]Create a Space API endpoint.
POST /spaces/{spaceId}/endpoints
Option | Description |
|---|---|
| name (required) |
| method (server default: "GET") One of: |
| path template (required; JSON) |
| param schema (JSON; server default: {}) |
| handler (required) One of: |
| handler config (required; JSON) |
| request contract (JSON; server default: {}) |
| response contract (JSON; server default: {}) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic endpoints delete [options] <endpointId>Delete a Space API endpoint.
DELETE /spaces/{spaceId}/endpoints/{endpointId} — destructive, requires --yes
Argument | Description |
|---|---|
| The endpoint id |
ligantic endpoints list [options]List a Space's API endpoints.
GET /spaces/{spaceId}/endpoints
ligantic endpoints openapi [options]Get the OpenAPI document for a Space's published endpoints.
GET /spaces/{spaceId}/endpoints/openapi.json
ligantic endpoints publish [options] <endpointId>Publish a Space API endpoint.
POST /spaces/{spaceId}/endpoints/{endpointId}/publish
Argument | Description |
|---|---|
| The endpoint id |
ligantic endpoints retire [options] <endpointId>Retire a Space API endpoint so it stops serving requests.
POST /spaces/{spaceId}/endpoints/{endpointId}/retire
Argument | Description |
|---|---|
| The endpoint id |
ligantic endpoints show [options] <endpointId>Get a Space API endpoint.
GET /spaces/{spaceId}/endpoints/{endpointId}
Argument | Description |
|---|---|
| The endpoint id |
ligantic endpoints update [options] <endpointId>Update a Space API endpoint.
PATCH /spaces/{spaceId}/endpoints/{endpointId}
Argument | Description |
|---|---|
| The endpoint id |
Option | Description |
|---|---|
| name |
| method One of: |
| path template (JSON) |
| param schema (JSON; server default: {}) |
| handler config (JSON) |
| request contract (JSON; server default: {}) |
| response contract (JSON; server default: {}) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiencesWork with Experiences
ligantic experiences block-types list [options]List the Experience block types.
GET /experience-block-types
ligantic experiences block-types show [options] <blockType>Describe the properties an Experience block type accepts.
Returns the block's properties and their types, for experiences blocks add --block and blocks update --changes.
GET /experience-block-types/{blockType}
Argument | Description |
|---|---|
| The block type |
ligantic experiences blocks add [options] <experienceId>Add a block to an Experience.
Adds the block, with any nested children, under parentId (the root block by default) and returns the new block's id. Block edits change the Experience's draft version; when the latest version is published, a new draft is created from it first. Publish with experiences versions publish.
POST /spaces/{spaceId}/experiences/{experienceId}/blocks
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| A block, such as |
| The box, link, or button block to add to (the root block by default). With no content yet, omit it to add the root block. |
| Position among the parent's children (the end by default) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences blocks delete [options] <experienceId> <blockId>Remove a block, with its children, from an Experience's draft.
DELETE /spaces/{spaceId}/experiences/{experienceId}/blocks/{blockId} — destructive, requires --yes
Argument | Description |
|---|---|
| The experience id |
| The block id |
ligantic experiences blocks move [options] <experienceId> <blockId>Move a block, with its children, within an Experience's draft.
POST /spaces/{spaceId}/experiences/{experienceId}/blocks/{blockId}/move
Argument | Description |
|---|---|
| The experience id |
| The block id |
Option | Description |
|---|---|
| The box, link, or button block to move it into (required) |
| Position among the new parent's children (the end by default) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences blocks outline [options] <experienceId>Outline an Experience version's blocks.
Returns the latest version's block tree as ids, types, names, and short text previews, without the other block properties. Use experiences blocks show to read one block in full.
GET /spaces/{spaceId}/experiences/{experienceId}/blocks
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| experience version id |
| block id |
| depth |
ligantic experiences blocks replace [options] <experienceId> <blockId>Replace one block, and its children, in an Experience's draft.
PUT /spaces/{spaceId}/experiences/{experienceId}/blocks/{blockId}
Argument | Description |
|---|---|
| The experience id |
| The block id |
Option | Description |
|---|---|
| A block, such as |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences blocks show [options] <experienceId> <blockId>Get one block of an Experience, with its children.
GET /spaces/{spaceId}/experiences/{experienceId}/blocks/{blockId}
Argument | Description |
|---|---|
| The experience id |
| The block id |
Option | Description |
|---|---|
| experience version id |
ligantic experiences blocks update [options] <experienceId> <blockId>Change properties of one block in an Experience's draft.
PATCH /spaces/{spaceId}/experiences/{experienceId}/blocks/{blockId}
Argument | Description |
|---|---|
| The experience id |
| The block id |
Option | Description |
|---|---|
| Properties to set on the block, merged into it. A |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences clone [options] <experienceId>Clone an Experience.
POST /spaces/{spaceId}/experiences/{experienceId}/clone
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| experience version id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences create [options]Create an Experience.
POST /spaces/{spaceId}/experiences
Option | Description |
|---|---|
| name (required) |
| title |
| pathname |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences delete [options] <experienceId>Delete an Experience.
DELETE /spaces/{spaceId}/experiences/{experienceId} — destructive, requires --yes
Argument | Description |
|---|---|
| The experience id |
ligantic experiences list [options]List Experiences in a Space.
GET /spaces/{spaceId}/experiences
Option | Description |
|---|---|
| omit unpublished |
| omit experiences with required path variables |
ligantic experiences rename [options] <experienceId>Rename an Experience.
PATCH /spaces/{spaceId}/experiences/{experienceId}
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| name (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences show [options] <experienceId>Get an Experience.
Returns the latest version of the Experience, or experienceVersionId when given.
GET /spaces/{spaceId}/experiences/{experienceId}
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| experience version id |
ligantic experiences versions create [options] <experienceId>Create a draft Experience version.
Creates a new draft version. version defaults to the latest version with its patch number incremented. Pass sourceExperienceVersionId to copy that version's metadata.
POST /spaces/{spaceId}/experiences/{experienceId}/versions
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| source experience version id |
| title (required) |
| pathname (required) |
| powered by logo removed (required) |
| block (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences versions list [options] <experienceId>List an Experience's versions.
Newest first. Pass the returned nextCursor back as cursor to fetch the next page.
GET /spaces/{spaceId}/experiences/{experienceId}/versions
Argument | Description |
|---|---|
| The experience id |
Option | Description |
|---|---|
| limit |
| cursor (JSON) |
ligantic experiences versions metadata delete [options] <experienceId> <experienceVersionId> <name>Remove an Experience version metadata entry.
Only draft versions can be changed.
DELETE /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}/metadata/{name} — destructive, requires --yes
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
| The name |
ligantic experiences versions metadata rename [options] <experienceId> <experienceVersionId> <currentName>Rename an Experience version metadata entry.
Moves the value to newName, replacing any value already set there. Only draft versions can be changed.
POST /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}/metadata/{currentName}/rename
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
| The current name |
Option | Description |
|---|---|
| new name (required) One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences versions metadata set [options] <experienceId> <experienceVersionId> <name>Set an Experience version metadata value.
Creates or replaces the metadata value, such as description or og:image. Only draft versions can be changed.
PUT /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}/metadata/{name}
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
| The name |
Option | Description |
|---|---|
| value (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences versions publish [options] <experienceId> <experienceVersionId>Publish an Experience version.
POST /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}/publish
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
ligantic experiences versions set-content [options] <experienceId> <experienceVersionId>Replace a draft Experience version's content.
Replaces the version's root block. Only draft versions can be changed.
PUT /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}/content
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
Option | Description |
|---|---|
| block (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic experiences versions update [options] <experienceId> <experienceVersionId>Update an Experience version's title and pathname.
Only draft versions can be changed.
PATCH /spaces/{spaceId}/experiences/{experienceId}/versions/{experienceVersionId}
Argument | Description |
|---|---|
| The experience id |
| The experience version id |
Option | Description |
|---|---|
| title (required) |
| pathname |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic foldersOrganise a Space's Schemas, Flows, and Experiences into folders
ligantic folders create [options]Create a folder.
POST /spaces/{spaceId}/folders
Option | Description |
|---|---|
| parent folder id |
| name (required) |
| icon |
| default open |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic folders delete [options] <folderId>Delete a folder.
DELETE /spaces/{spaceId}/folders/{folderId} — destructive, requires --yes
Argument | Description |
|---|---|
| The folder id |
ligantic folders move [options]Move folders, Flows, Schemas, or Experiences into a folder.
POST /spaces/{spaceId}/folders/move-items
Option | Description |
|---|---|
| folder id (required) |
| folder ids |
| flow ids |
| schema ids |
| experience ids |
| new children order |
| destination children hash |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic folders reorder [options]Reorder the items in a folder.
POST /spaces/{spaceId}/folders/reorder-children
Option | Description |
|---|---|
| folder id (required) |
| children (required) |
| children hash |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic folders tree [options]Get a Space's folder tree.
GET /spaces/{spaceId}/folders
ligantic folders update [options] <folderId>Rename or restyle a folder.
PATCH /spaces/{spaceId}/folders/{folderId}
Argument | Description |
|---|---|
| The folder id |
Option | Description |
|---|---|
| name |
| icon |
| default open |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisationsManage organisations
ligantic organisations agents api-keys create [options] <controllingOrganisationId> <agentId>Create an API key for an organisation agent.
POST /organisations/{controllingOrganisationId}/agents/{agentId}/api-keys
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
Option | Description |
|---|---|
| name |
| expires at |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations agents api-keys delete [options] <controllingOrganisationId> <agentId> <apiKeyId>Delete an organisation agent's API key.
DELETE /organisations/{controllingOrganisationId}/agents/{agentId}/api-keys/{apiKeyId} — destructive, requires --yes
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
| The api key id |
ligantic organisations agents api-keys list [options] <controllingOrganisationId> <agentId>List an organisation agent's API keys.
GET /organisations/{controllingOrganisationId}/agents/{agentId}/api-keys
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
ligantic organisations agents create [options] <controllingOrganisationId>Create an organisation agent.
POST /organisations/{controllingOrganisationId}/agents
Argument | Description |
|---|---|
| The controlling organisation id |
Option | Description |
|---|---|
| name |
| If true, the agent will be added as a member of the organisation. By default, the agent will not be added as a member. (server default: false) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations agents delete [options] <controllingOrganisationId> <agentId>Delete an organisation agent.
DELETE /organisations/{controllingOrganisationId}/agents/{agentId} — destructive, requires --yes
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
ligantic organisations agents list [options] <controllingOrganisationId>List an organisation's agents.
GET /organisations/{controllingOrganisationId}/agents
Argument | Description |
|---|---|
| The controlling organisation id |
ligantic organisations agents show [options] <controllingOrganisationId> <agentId>Get an organisation agent.
GET /organisations/{controllingOrganisationId}/agents/{agentId}
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
ligantic organisations agents spaces [options] <controllingOrganisationId> <agentId>List the Spaces an organisation agent belongs to.
GET /organisations/{controllingOrganisationId}/agents/{agentId}/spaces
Argument | Description |
|---|---|
| The controlling organisation id |
| The agent id |
ligantic organisations billing accounts create [options] <organisationId>Create an organisation billing account.
Create a new billing account for an organisation
POST /organisations/{organisationId}/billing/accounts
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| name (required) |
| organisation address id (required) |
| tax id (required; JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations billing accounts list [options] <organisationId>List an organisation's billing accounts.
Get all billing accounts for an organisation
GET /organisations/{organisationId}/billing/accounts
Argument | Description |
|---|---|
| The organisation id |
ligantic organisations billing accounts show [options] <organisationId> <organisationBillingAccountId>Get an organisation billing account.
Get a specific billing account for an organisation
GET /organisations/{organisationId}/billing/accounts/{organisationBillingAccountId}
Argument | Description |
|---|---|
| The organisation id |
| The organisation billing account id |
ligantic organisations billing addresses create [options] <organisationId>Create an organisation billing address.
Create a new billing address for an organisation
POST /organisations/{organisationId}/billing/addresses
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| type (required) One of: |
| name (required) |
| address line1 (required) |
| address line2 |
| city (required) |
| state (required) |
| postal code (required) |
| country (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations billing addresses list [options] <organisationId>List an organisation's billing addresses.
Get all billing addresses for an organisation
GET /organisations/{organisationId}/billing/addresses
Argument | Description |
|---|---|
| The organisation id |
ligantic organisations billing addresses show [options] <organisationId> <organisationAddressId>Get an organisation billing address.
Get a specific billing address for an organisation
GET /organisations/{organisationId}/billing/addresses/{organisationAddressId}
Argument | Description |
|---|---|
| The organisation id |
| The organisation address id |
ligantic organisations billing credits list [options] <organisationId> <organisationBillingAccountId>List the credits of an organisation billing account.
Get all credits for a billing account
GET /organisations/{organisationId}/billing/accounts/{organisationBillingAccountId}/credits
Argument | Description |
|---|---|
| The organisation id |
| The organisation billing account id |
ligantic organisations billing credits usages [options] <organisationId> <organisationBillingAccountId> <organisationCreditId>List the usage recorded against an organisation credit.
Get usage statistics for a specific credit
GET /organisations/{organisationId}/billing/accounts/{organisationBillingAccountId}/credits/{organisationCreditId}/usages
Argument | Description |
|---|---|
| The organisation id |
| The organisation billing account id |
| The organisation credit id |
Option | Description |
|---|---|
| offset (server default: 0) |
| limit (server default: 10) |
ligantic organisations create [options]Create an organisation.
Create a new organisation
POST /organisations
Option | Description |
|---|---|
| display name (required) |
| labels (JSON) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations delete [options] <organisationId>Delete an organisation.
Remove an organisation
DELETE /organisations/{organisationId} — destructive, requires --yes
Argument | Description |
|---|---|
| The organisation id |
ligantic organisations invites accept [options] <organisationInviteId>Accept an organisation invite.
POST /organisations/invites/{organisationInviteId}/accept
Argument | Description |
|---|---|
| The organisation invite id |
ligantic organisations invites decline [options] <organisationInviteId>Decline an organisation invite.
POST /organisations/invites/{organisationInviteId}/decline
Argument | Description |
|---|---|
| The organisation invite id |
ligantic organisations invites pending [options]List your pending organisation invites.
Get all pending invites for the authenticated user
GET /organisations/invites/pending
ligantic organisations leave [options] <organisationId>Leave an organisation.
POST /organisations/{organisationId}/leave — destructive, requires --yes
Argument | Description |
|---|---|
| The organisation id |
ligantic organisations list [options]List your organisations.
Get all organisations for the authenticated user
GET /organisations
ligantic organisations members set-role [options] <organisationId> <membershipId>Change an organisation member's role.
Update a member's role in an organisation
PATCH /organisations/{organisationId}/members/{membershipId}/role
Argument | Description |
|---|---|
| The organisation id |
| The membership id |
Option | Description |
|---|---|
| membership type (required) One of: |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations show [options] <organisationId>Get an organisation.
Get an organisation by ID
GET /organisations/{organisationId}
Argument | Description |
|---|---|
| The organisation id |
ligantic organisations spaces join [options] <organisationId>Join an organisation's Space.
Join a space within an organisation
POST /organisations/{organisationId}/spaces/{spaceId}/join
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| as agent id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations spaces list [options] <organisationId>List an organisation's Spaces.
Get all spaces for an organisation
GET /organisations/{organisationId}/spaces
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| as agent id |
ligantic organisations spaces set-billing-account [options] <organisationId>Set the billing account of an organisation's Space.
Set the billing account for a space
POST /organisations/{organisationId}/spaces/{spaceId}/set-billing-account
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| organisation billing account id (required) |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations spaces transfer-to-organisation [options] <organisationId>Transfer a Space to an organisation.
Transfer a space to another organisation
POST /organisations/{organisationId}/spaces/{spaceId}/transfer-to-organisation — destructive, requires --yes
Argument | Description |
|---|---|
| The organisation id |
Option | Description |
|---|---|
| organisation billing account id |
| The request body as JSON, @file, or - for stdin; flags override its fields |
ligantic organisations spaces transfer-to-user [options] <organisationId>Transfer a Space to a user.
Transfer a space to your user
POST /organisations/{organisationId}/spaces/{spaceId}/transfer-to-user — destructive, requires --yes
Argument | Description |
|---|---|
| The organisation id |