Cults connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Cults actions: "Get Approved Origins", "Cults GraphQL POST" and "Share on Create (FR)". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Cults, with input parameters and output schema.
CULTS_GET_APPROVED_ORIGINSInspects the Cults creation page to detect any sharing origin information. Note: Cults requires origins to be manually approved via support contact before use with the Share on Create feature. This action attempts to parse the creation page for origin-related data but may return empty results. For guaranteed origin information, contact Cults support directly at https://cults3d.com/en/api.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CULTS_GRAPH_QL_POSTExecute GraphQL queries and mutations against the Cults3D API. Cults3D is a marketplace for 3D printable models. This tool provides access to: - Browse and search 3D model designs (creations) - View user profiles and their uploaded models - Access your own account data, sales, and printlists (via 'myself' query) - Manage your creations and discounts (via mutations) The API uses standard GraphQL syntax. Query the schema for available fields. Note: 3D model files themselves are not accessible via the API, only metadata.
Input parameters
GraphQL query or mutation string to execute against the Cults3D API. Use standard GraphQL syntax. Common queries include: creationsBatch (list designs), creation(slug:) (get design details), user(nick:) (get user profile), myself (get authenticated user info), categories (list categories). For mutations: createCreation, updateCreation, createDiscount.
Variables to pass to the GraphQL query. Use this when your query contains variable placeholders like $slug or $limit. Example: {"slug": "my-model", "limit": 10}
Name of the specific operation to execute when the query string contains multiple named operations. Only required for multi-operation queries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
CULTS_SHARE_ON_CREATE_FRGenerate a one-click share URL for publishing a 3D file to Cults (French locale). This tool constructs a shareable link that, when clicked by users, takes them to the Cults creation page with the 3D file URL pre-filled. This enables seamless sharing of 3D models from your platform to Cults. Prerequisites: - Your site/origin must be pre-approved by Cults for share integration - The file_url must point to a publicly accessible 3D file Note: This action generates the URL without making an API call, so it always succeeds as long as the parameters are valid. Users will need to be logged into Cults to complete the sharing process.
Input parameters
Your site's domain name, pre-approved by Cults for share integration. Example: 'mysite.com'
Absolute URL of the 3D file to share (e.g., STL, OBJ). The URL should be publicly accessible. Example: 'https://mysite.com/models/gear.stl'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 3 Cults actions on Nagent: "Get Approved Origins", "Cults GraphQL POST" and "Share on Create (FR)". Get Approved Origins: Inspects the Cults creation page to detect any sharing origin information. Each action is listed on this page with its input parameters and its output.
Cults connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It returns data, error and successful.