Afineo Webservices API v3

Afineo is a PIM (Product Information Management), DAM (Digital Asset Management) and MDM (Master Data Management) platform. This page lists all 144 REST endpoints across 18 modules.

Machine-readable specifications: full OpenAPI 3.0 spec · llms.txt summary

Authentication: all endpoints except /api/v3/token/get/ require a JWT bearer token (Authorization: Bearer <token>). Responses: every response is {"status_code":1,"status_message":"…","result":…} — status_code 1 = success, 2 = validation error, 3 = no result, 0 = system error.

Base URL: each client has its own instance — https://{instance}.afineo.io/api/v3/

administration

Read-only access to platform structure: list available libraries (classes) and versions. Use this to discover the data model foundation (library IDs, names) before querying other modules like attributes or types.

Module spec: /openapi/administration.json (2 endpoints)

POST /api/v3/administration/classes/list/

classes/list — List all available classes

Returns all configured data structures (libraries) in the system.

POST /api/v3/administration/versions/list/

versions/list — List available versions

Returns available language versions (locales) configured in the system.

attributes

Define and manage asset attributes (fields) within a library: create attributes, organize them into tabs and groups, assign them to types, and retrieve JSON schemas for validation. This is the core module for data model configuration.

Module spec: /openapi/attributes.json (17 endpoints)

POST /api/v3/attributes/assign-masks/

assign-masks — Sync display mask permissions for an attribute (add, update, remove)

Synchronizes display mask permissions for a single attribute. Send the complete desired state for all masks: the endpoint computes a diff and applies additions, updates, and removals automatically.

Required parameters: id, assignments

POST /api/v3/attributes/assign-types/

assign-types — Sync type assignments for an attribute (add, update, remove)

Synchronizes which record types an attribute is assigned to, along with per-type display options. Send the complete desired state for this attribute: the endpoint computes a diff and applies additions, updates, and removals automatically.

Required parameters: id, assignments

POST /api/v3/attributes/batch-create/

batch-create — Create multiple attributes in batch

Creates multiple attributes in a single call with cache revalidation only at the end, improving performance for bulk operations.

Required parameters: class_id, attributes

POST /api/v3/attributes/create/

create — Create a new attribute

Creates a new attribute with validation against the JSON schema for the specified data_type.

Required parameters: class_id, tab_id, data_type, label, type

POST /api/v3/attributes/full/

full — Get all attributes with full configuration

Returns complete information about all attributes of a class with full configuration.

Required parameters: class_id

POST /api/v3/attributes/get/

get — Get attribute configuration

Returns complete field definition (type, validation rules, list values, display settings, permissions).

Required parameters: id

POST /api/v3/attributes/groups/create/

groups/create — Create a new attribute group

Creates a new attribute group within a tab. Groups organize attributes by theme within a tab.

Required parameters: class_id, tab_id, label

POST /api/v3/attributes/groups/list/

groups/list — List attribute groups

Returns attribute groups within tabs for a library. Groups organize attributes within tabs.

Required parameters: class_id

POST /api/v3/attributes/groups/update/

groups/update — Update an existing attribute group

Updates properties of an existing attribute group. Only provided fields are modified — omitted fields remain unchanged.

Required parameters: id

POST /api/v3/attributes/list/

list — List the attributes of a library with their data type, tab and group

Returns essential attribute information (id, code, label, data_type) for a class.

Required parameters: class_id

POST /api/v3/attributes/masks/

masks — Get attribute mask permissions

Returns display mask assignments and permissions for an attribute.

Required parameters: id

POST /api/v3/attributes/schema/

schema — Get attribute schema by data type

Returns the JSON schema defining all available properties for a specific attribute data type.

Required parameters: data_type

POST /api/v3/attributes/tabs/create/

tabs/create — Create a new attribute tab

Creates a new display tab in a library. Tabs organize attributes into logical sections in the asset editing interface.

Required parameters: class_id, label

POST /api/v3/attributes/tabs/list/

tabs/list — List attribute tabs

Returns attribute tabs (form sections) for a library. Tabs organize attributes into logical groups in the asset editing interface.

Required parameters: class_id

POST /api/v3/attributes/tabs/update/

tabs/update — Update an existing attribute tab

Updates properties of an existing display tab. Only provided fields are modified — omitted fields remain unchanged.

Required parameters: id

POST /api/v3/attributes/types/

types — Get attribute type assignments

Returns asset type assignments for an attribute.

Required parameters: id

POST /api/v3/attributes/update/

update — Update an existing attribute

Updates an existing attribute's properties. Only send the properties you want to change.

Required parameters: id

export

Export asset data using predefined mappings. Supports repository and project contexts, file-based exports (CSV, XML) via background jobs, and EasyCatalog format. Use processes/get to track export job status and retrieve generated files.

Module spec: /openapi/export.json (6 endpoints)

POST /api/v3/export/by-mapping/node/

by-mapping/node — Export project node data by mapping

Exports project-contextualized assets to JSON using a mapping with pagination and filters.

Required parameters: class_id, parent_id, mapping_id, num_page, results_per_page

POST /api/v3/export/by-mapping/repository/

by-mapping/repository — Export repository data by mapping

Exports repository assets to JSON using a preconfigured mapping with pagination and filters.

Required parameters: class_id, mapping_id, num_page, results_per_page

POST /api/v3/export/easycatalog/

easycatalog — Export for EasyCatalog InDesign

Generates InDesign-compatible export for EasyCatalog plugin. Returns formatted data for print catalog production. Supports column mapping discovery, first result preview, and thematiques listing.

Required parameters: class_id, node_id, action

POST /api/v3/export/get-file/

get-file — Get export file by queue ID

Returns file information (name, size, URL) for a completed export using the queue_id.

Required parameters: queue_id

POST /api/v3/export/jobs-by-mapping/node/

jobs-by-mapping/node — Async export project node to file

Generates file export from project-contextualized data (CSV/XLS/XLSX/TXT/XML/JSON). Returns queue_id for async processing.

Required parameters: class_id, parent_id, mapping_id

POST /api/v3/export/jobs-by-mapping/repository/

jobs-by-mapping/repository — Async export repository to file

Generates file export from repository (CSV/XLS/XLSX/TXT/XML/JSON). Returns queue_id for async processing.

Required parameters: class_id, mapping_id

get-asset

Retrieve asset data by search criteria or by ID. Supports both repository (master data) and project (contextual data) contexts. Use this to read asset information without modifying it.

Module spec: /openapi/get-asset.json (4 endpoints)

POST /api/v3/get-asset/by-id/node/

by-id/node — Get project node asset by ID

Returns project-contextualized asset with all attribute values (includes project-specific overrides).

Required parameters: id, class_id

POST /api/v3/get-asset/by-id/repository/

by-id/repository — Get repository asset by ID

Returns complete repository asset with all attribute values (master data without project overrides).

Required parameters: id, class_id

POST /api/v3/get-asset/by-search/node/

by-search/node — Search project node assets by filters

Returns project-contextualized assets matching filters with pagination and custom attribute selection.

Required parameters: class_id, parent_id, num_page, results_per_page

POST /api/v3/get-asset/by-search/repository/

by-search/repository — Search repository assets by filters

Returns repository assets matching filters with pagination and custom attribute selection.

Required parameters: class_id, parent_id, num_page, results_per_page

import

Import asset data into the platform. Supports auto-mapped imports and JSON/JSONL formats, in both repository and project contexts. Data can be sent inline via the data parameter or as a file upload.

Module spec: /openapi/import.json (4 endpoints)

POST /api/v3/import/auto/node/

auto/node — Auto-mapped import in node (project context)

Imports data from CSV or Excel files into a specific node/project context using automatic attribute mapping based on column headers.

Required parameters: class_id, parent_id, mode

POST /api/v3/import/auto/repository/

auto/repository — Auto-mapped import in repository

Imports data from CSV or Excel files into the repository using automatic attribute mapping based on column headers.

Required parameters: class_id, mode

POST /api/v3/import/json/node/

json/node — Import JSON/JSONL data in node (project context)

Imports data from JSON or JSONL format into a specific node/project context. Supports two input modes: 1. Inline data: Pass JSON data directly via the data parameter 2. File upload: Upload a JSON/JSONL file via multipart/form-data

Required parameters: class_id, parent_id, mode

POST /api/v3/import/json/repository/

json/repository — Import JSON/JSONL data in repository

Imports data from JSON or JSONL format into the repository. Supports two input modes: 1. Inline data: Pass JSON data directly via the data parameter 2. File upload: Upload a JSON/JSONL file via multipart/form-data

Required parameters: class_id, mode

listvalues

Manage dropdown lists (list values) used by select-type attributes: create lists, add options, and update existing values. These are the predefined option sets that populate dropdown, checkbox and radio attributes.

Module spec: /openapi/listvalues.json (6 endpoints)

POST /api/v3/listvalues/add-option/

add-option — Add option to list value

Adds a new option (choice) to an existing dropdown list.

Required parameters: list_id, value

POST /api/v3/listvalues/create/

create — Create a new dropdown list

Creates a new dropdown list (list value) in a library, optionally with initial options (values).

Required parameters: class_id, label

POST /api/v3/listvalues/full/

full — Get list values for dropdowns

Returns all dropdown options configured for a class with full details (options, linked attributes, versions).

Required parameters: class_id

POST /api/v3/listvalues/get/

get — Get list value details

Returns complete information for a single list value including all options, linked attributes, and version data.

Required parameters: id

POST /api/v3/listvalues/list/

list — List dropdown configurations

Returns the dropdown lists configured for a library, with their id, portable code, label and tags — without their options. Use POST /api/v3/listvalues/get/ to read the options of one list.

Required parameters: class_id

POST /api/v3/listvalues/update/

update — Update a dropdown list with full options synchronization

Updates an existing dropdown list: its label and/or its options. When values is provided, the endpoint performs a full synchronization of the list options.

Required parameters: id

mappings

Read-only access to field mapping configurations: list available mappings and retrieve mapping details. Mappings define how data is transformed during import and export operations.

Module spec: /openapi/mappings.json (7 endpoints)

POST /api/v3/mappings/create-export/

create-export — Create an export mapping

Creates a new export mapping for a library (class) with structured column definitions, format options, and export configuration.

Required parameters: class_id, label, export_formats, columns

POST /api/v3/mappings/create-import/

create-import — Create an import mapping

Creates a new import mapping for a library (class) that defines how file columns map to Afineo attributes, with reconciliation keys, import mode, and optional transformations.

Required parameters: class_id, label, import_mode, column_mappings

POST /api/v3/mappings/full/

full — Get all mappings for a class

Returns all mappings for a class grouped by type (export, import, asset_view, search_view, dynamic_grouped_view).

Required parameters: class_id

POST /api/v3/mappings/get/

get — Get mapping details

Returns complete mapping configuration including metadata, permissions, and full data structure.

Required parameters: id

POST /api/v3/mappings/list/

list — List mappings by class and type

Returns the mappings of a library for one mapping type, with their id, portable code, label and tags — without their column configuration.

Required parameters: class_id, type

POST /api/v3/mappings/update-export/

update-export — Update an existing export mapping

Updates an existing export mapping configuration. All parameters except id are optional — only provided fields are updated.

Required parameters: id

POST /api/v3/mappings/update-import/

update-import — Update an existing import mapping

Updates an existing import mapping configuration. All parameters except id are optional — only provided fields are updated.

Required parameters: id

permissions

Read-only access to access control configuration: list and retrieve user groups, permission profiles, display masks, and asset statuses. Use this to discover permission structures and their IDs for use in other API calls.

Module spec: /openapi/permissions.json (13 endpoints)

POST /api/v3/permissions/groups/full/

groups/full — Get full user group permissions

Returns complete permissions configuration for all user groups (profiles, statuses, languages, display masks, overloads).

POST /api/v3/permissions/groups/get/

groups/get — Get user group details

Returns complete configuration for a specific user group by ID.

Required parameters: id

POST /api/v3/permissions/groups/list/

groups/list — List user groups (id and label only)

Returns every user group of the instance, with its id and label only. Use it to resolve a group name to its id, or to populate a group selector.

POST /api/v3/permissions/masks/assign-attributes/

masks/assign-attributes — Sync attribute permissions for a display mask, scoped to a library (add, update, remove)

Synchronizes which attributes are visible/editable in a display mask, scoped to a single library. Send the complete desired state for all attributes of that library in the mask: the endpoint computes a diff and applies additions, updates, and removals automatically.

Required parameters: id, class_id, assignments

POST /api/v3/permissions/masks/full/

masks/full — Get all display masks with details

Returns all display masks for a class with attribute-level read/write/hidden permissions.

Required parameters: class_id

POST /api/v3/permissions/masks/get/

masks/get — Get display mask details

Returns complete mask configuration with attribute-level permissions (read/write/hidden) for a specific class.

Required parameters: id, class_id

POST /api/v3/permissions/masks/list/

masks/list — List display masks (id, code and label only)

Returns every display mask of the instance, with its id, portable code and label.

POST /api/v3/permissions/profiles/full/

profiles/full — Get full profile permissions

Returns all profiles with complete permissions configuration (module access, universes, mount points, statuses).

POST /api/v3/permissions/profiles/get/

profiles/get — Get profile details

Returns complete permissions configuration for a specific profile by ID.

Required parameters: id

POST /api/v3/permissions/profiles/list/

profiles/list — List profiles grouped by profile type (general, project, asset)

Returns every profile of the instance, grouped by profile type (general, project, asset). Each profile carries its id, portable code and label.

POST /api/v3/permissions/statuses/full/

statuses/full — Get all statuses with details

Returns workflow statuses for a class with full details (default flag, color configuration).

Required parameters: class_id

POST /api/v3/permissions/statuses/get/

statuses/get — Get status details

Returns complete status configuration by ID (label, class, default flag, color).

Required parameters: id

POST /api/v3/permissions/statuses/list/

statuses/list — List the statuses available in a library

Returns the statuses available in a library, with their id, portable code, label and owning library.

Required parameters: class_id

preferences

Manage display preferences per library context: column visibility, sort order, and layout settings. These control how asset lists are presented to users.

Module spec: /openapi/preferences.json (4 endpoints)

POST /api/v3/preferences/full/

full — Get all preferences for a library with full context, type/supertype/node assignments and attributes

Returns all user preferences for a class with complete configuration (context, type/supertype/node assignments, attributes).

Required parameters: class_id

POST /api/v3/preferences/get/

get — Get preference by context (general / supertype / type / node)

Returns preference configuration for a specific context.

Required parameters: class_id, id, context

POST /api/v3/preferences/list/

list — List preferences for a library with their allowed contexts (use to discover which context to pass to preferences/get or /update)

Returns the preferences of a library with their id, portable code, label, tags and allowed contexts, without the attribute detail of each preference.

Required parameters: class_id

POST /api/v3/preferences/update/

update — Update preference attributes for a given context (general / supertype / type / node)

Updates the list of attributes assigned to a preference for a given context (general, supertype, type, or node).

Required parameters: class_id, id, context, attribute_ids

processes

Execute and monitor background processes (ETL, exports, transformations). Launch a process, track its state via polling, retrieve execution logs and download generated files when complete.

Module spec: /openapi/processes.json (9 endpoints)

POST /api/v3/processes/connections/

connections — List external connections

Returns configured external connections (integrations) available for use in process actions.

POST /api/v3/processes/execute/

execute — Execute automated process

Launches an automation and returns identification key for progress tracking.

Required parameters: id, class_id

POST /api/v3/processes/full/

full — List processes (full details)

Returns all processes for a class with complete configuration (actions, permissions, triggers, schedulers, callers).

Required parameters: class_id

POST /api/v3/processes/get-file/

get-file — Download process-generated file

Downloads file generated by a completed process using identification_key and file_key.

Required parameters: identification_key, file_key

POST /api/v3/processes/get-instance-state/

get-instance-state — Check process execution status

Returns real-time execution state and available files using identification_key from execute endpoint.

Required parameters: identification_key

POST /api/v3/processes/get-logs/

get-logs — Get process execution logs

Returns execution history with status details for troubleshooting and auditing.

Required parameters: id

POST /api/v3/processes/get/

get — Get process configuration

Returns complete process definition including actions, parameters, triggers, availability settings, and which processes call this one.

Required parameters: id

POST /api/v3/processes/list/

list — List the processes of a library with their trigger type and scheduling

Returns the processes of a library with their id, portable code, label, tags, trigger type, availability and scheduling status.

Required parameters: class_id

POST /api/v3/processes/schedulers/

schedulers — List scheduled processes

Returns schedulers with next execution dates and recurrence configuration for a library.

Required parameters: class_id

projects

Manage project trees within a library: create projects, list them, and retrieve project details. Projects are contextual workspaces where assets can be organized independently from the main repository.

Module spec: /openapi/projects.json (4 endpoints)

POST /api/v3/projects/create/

create — Create a directory project or a document holder

Creates a new project under a parent workspace with specified type and configuration.

Required parameters: class_id, workspace_node_id, label, project_type

POST /api/v3/projects/full/

full — Get all projects with full details

Returns all workspaces and projects for a class with complete configuration (dates, versions, groups, permissions).

Required parameters: class_id

POST /api/v3/projects/get/

get — Get project details

Returns complete project configuration including type, dates, versions, groups, display settings, and permissions.

Required parameters: id

POST /api/v3/projects/list/

list — List the projects of a library with their workspace and dates

Returns the projects of a library, flat across all workspaces. Each project carries its node_id, its workspace and its dates.

Required parameters: class_id

publishing

Manage publication projects for catalog and document generation: create publications, manage pages, place products in blocks, assign themes, and control page layout. This is the complete print/digital publishing workflow.

Module spec: /openapi/publishing.json (25 endpoints)

POST /api/v3/publishing/add-block-to-page/

add-block-to-page — Add a single content block to a page

Adds one content block to one publication page. To add several blocks, or to cover several pages in a single call, use POST /api/v3/publishing/add-blocks-to-pages/.

Required parameters: class_id, project_node_id, page_num, block

POST /api/v3/publishing/add-blocks-to-pages/

add-blocks-to-pages — Add content blocks to pages

Defines page layout by adding content blocks to publication pages. Configure block positioning and content for print catalog production.

Required parameters: class_id, project_node_id, pages

POST /api/v3/publishing/add-empty-block/

add-empty-block — Add an empty block to a page

Creates an empty placeholder block on a publication page. Empty blocks reserve space for future product placement.

Required parameters: class_id, project_node_id, page_num, x_position, y_position, width, height

POST /api/v3/publishing/add-notepad/

add-notepad — Add a notepad to a page

Creates a notepad element on a publication page. Notepads are annotation elements for collaboration (pins, simple notes).

Required parameters: class_id, project_node_id, page_num, notepad_type, html_content

POST /api/v3/publishing/add-pages/

add-pages — Add one or several pages to a publication

Inserts one or several empty pages into an existing publication, at the end by default, or at a given position. The remaining pages are automatically renumbered by the platform: a page number is the position of the page in the publication, so inserting a page shifts every…

Required parameters: class_id, project_node_id, number_of_pages

POST /api/v3/publishing/add-product-to-page/

add-product-to-page — Add a product to a publication page tree

Adds a product from the repository to a publication page tree. The product becomes a child of the page, making it available for block placement via place-product-in-page.

Required parameters: class_id, project_node_id, page_num, asset_id

POST /api/v3/publishing/add-products-to-pages/

add-products-to-pages — Add products to publication pages (batch)

Batch endpoint for adding products from the repository to multiple publication pages. Each product becomes a child of its target page.

Required parameters: class_id, project_node_id, pages

POST /api/v3/publishing/add-text-block/

add-text-block — Add a text block to a page

Creates a text block with HTML content on a publication page. Text blocks display formatted content independently of products.

Required parameters: class_id, project_node_id, page_num, x_position, y_position, width, height, html_content

POST /api/v3/publishing/add-theme-to-page/

add-theme-to-page — Associate a single theme to a single page

Assigns one theme to one publication page. To assign several themes, or to cover several pages in a single call, use POST /api/v3/publishing/add-themes-to-pages/.

Required parameters: class_id, project_node_id, page_num, theme

POST /api/v3/publishing/add-themes-to-pages/

add-themes-to-pages — Associate themes to pages

Assigns thematic categories to publication pages. Use for organizing print catalog content by themes (seasonal, product families, promotional sections).

Required parameters: class_id, project_node_id, pages

POST /api/v3/publishing/create/

create — Create a publication or a paginated catalog project

Creates a new publication or catalog project within a project group. Configure project type, page dimensions, and initial settings.

Required parameters: class_id, workspace_node_id, label, project_type

POST /api/v3/publishing/delete-block-to-page/

delete-block-to-page — Remove a content block from a page

Deletes a content block from a publication page, whatever its type (product, empty, text, image, note). Also removes any associated form data.

Required parameters: block_id

POST /api/v3/publishing/delete-pages/

delete-pages — Delete one or several pages of a publication

Removes one or several pages from a publication. The remaining pages are automatically renumbered.

Required parameters: class_id, project_node_id, page_nums

POST /api/v3/publishing/delete-theme-to-page/

delete-theme-to-page — Remove a theme from a page

Removes a theme from a specific publication page. Reverse operation of add-theme-to-page.

Required parameters: class_id, project_node_id, page_num, theme

POST /api/v3/publishing/get-block-form-by-attribute/

get-block-form-by-attribute — Get forms in a project by attribute value

Retrieves all forms in a publication project matching a specific attribute value. Useful for finding forms based on their content.

Required parameters: class_id, project_node_id, attribute_id, value

POST /api/v3/publishing/get-publication-details/

get-publication-details — Get publication details

Returns complete details of a publication including dimensions, page count, display mode, and associated themes.

Required parameters: class_id, project_node_id

POST /api/v3/publishing/get-publication-pages/

get-publication-pages — Get publication pages list

Returns a paginated list of pages in a publication with their status and block count.

Required parameters: class_id, project_node_id

POST /api/v3/publishing/list/

list — List publication projects

Returns publication projects grouped by workspace.

Required parameters: class_id

POST /api/v3/publishing/move-pages/

move-pages — Move one or several pages inside a publication

Reorders a publication by moving one or several pages to a given position. The moved pages are grouped together as a contiguous block starting at that position, in the order given by page_nums. Every page of the publication is then automatically renumbered.

Required parameters: class_id, project_node_id, page_nums, at_page_num

POST /api/v3/publishing/page-details/

page-details — Get page details with blocks

Returns complete details of a publication page including themes and all blocks with their positions, content, and metadata.

Required parameters: class_id, project_node_id, page_num

POST /api/v3/publishing/place-product-in-page/

place-product-in-page — Place a product on a publication page

Intelligent endpoint for placing a product on a publication page. Handles the full workflow: adding the product from the repository to the page tree if needed, then creating a new product block or assigning the product to an existing block.

Required parameters: class_id, project_node_id, page_num

POST /api/v3/publishing/place-products-in-pages/

place-products-in-pages — Place products on publication pages (batch)

Batch endpoint for placing multiple products on multiple publication pages. Each product follows the same workflow as place-product-in-page: adding from repository if needed, then creating or assigning blocks.

Required parameters: class_id, project_node_id, pages

POST /api/v3/publishing/unassign-product-from-block/

unassign-product-from-block — Remove a product from a block

Removes the product assignment from a product block, converting it back to an empty block. Associated form data is preserved.

Required parameters: class_id, project_node_id, block_id

POST /api/v3/publishing/update-block-to-page/

update-block-to-page — Update a content block on a page

Updates an existing content block on a publication page. Modify position, dimensions, content, or associated data. Only provided properties are updated.

Required parameters: class_id, project_node_id, page_num, block_id, block

POST /api/v3/publishing/update-status/node/

update-status/node — Update page status in publication project

Updates the access control status (LCA) of a publication page by page number. This endpoint operates in the project/node context (not repository).

Required parameters: page_num, class_id, project_node_id, status_id

queues

Monitor the message queue system: list queues, get queue details, and view queue types. Queues handle asynchronous job processing (imports, exports, transformations) across the platform.

Module spec: /openapi/queues.json (3 endpoints)

POST /api/v3/queues/get/

get — Get queue details

Returns detailed queue information by ID including file download URL for finished jobs.

Required parameters: id

POST /api/v3/queues/list/

list — List queue items

Returns background job queue with execution status and optional filtering by status, type, and date range.

POST /api/v3/queues/types/

types — List queue types

Returns available background job categories (Import, Export, Process, Delete) for filtering queue lists.

record-asset

Full asset lifecycle management: create, update, delete, move and copy assets in both repository and project contexts. Also handles file uploads, status changes, type reassignment, and tree operations (move, copy, detach).

Module spec: /openapi/record-asset.json (19 endpoints)

POST /api/v3/record-asset/add-asset-to-project/

add-asset-to-project — Add repository asset to project

Creates a contextualized node from a repository asset in a project. Returns created node_id.

Required parameters: class_id, asset_id, parent_node_id

POST /api/v3/record-asset/available-attributes-creation/

available-attributes-creation — Get available attributes for creation

Returns list of available attributes for a specific type to help build dynamic creation forms.

Required parameters: type_id

POST /api/v3/record-asset/copy-node-in-project/

copy-node-in-project — Copy node in project

Duplicates a node (and children) to a new location within the project. Returns new node_id.

Required parameters: class_id, node_id, parent_node_id

POST /api/v3/record-asset/create/node/

create/node — Create node in project

Creates a new contextualized node directly in project (not linked to repository).

Required parameters: class_id, type_id, parent_id

POST /api/v3/record-asset/create/repository/

create/repository — Create asset in repository

Creates a new master data record in repository with initial attribute values.

Required parameters: class_id, type_id, parent_id

POST /api/v3/record-asset/destroy/node/

destroy/node — Delete node and repository asset

IRREVERSIBLY removes both project node AND repository master data with all children. Cascading deletion affects all projects.

Required parameters: class_id

POST /api/v3/record-asset/destroy/repository/

destroy/repository — Delete repository asset permanently

IRREVERSIBLY removes asset and children from repository. Prefer detach for reversible removal.

Required parameters: class_id

POST /api/v3/record-asset/detach/node/

detach/node — Detach node from project

Removes node from project tree without affecting repository. Removing a parent removes automaticaly the children. Repository asset remains intact.

Required parameters: class_id

POST /api/v3/record-asset/detach/repository/

detach/repository — Detach asset from repository tree

Moves asset and children to Unclassified folder (reversible). Asset remains accessible for reclassification.

Required parameters: class_id

POST /api/v3/record-asset/move-asset-in-repository/

move-asset-in-repository — Move an asset to a different parent in the repository hierarchy

Moves an asset (and its children) to a new parent location within the repository hierarchy.

Required parameters: class_id, asset_id, parent_id

POST /api/v3/record-asset/move-node-in-project/

move-node-in-project — Move node in project

Moves a node (and children) to a new parent location within the project.

Required parameters: class_id, node_id, parent_node_id

POST /api/v3/record-asset/repoint/node/

repoint/node — Repoint a node to a different asset

Repoints a node (project position) to a different asset (master record). Useful to correct import mistakes.

Required parameters: node_id, asset_id, class_id

POST /api/v3/record-asset/update-datas/node/

update-datas/node — Update project node attributes

Updates project-specific attribute values (simple and multiple types) for an existing node. Creates contextualized overrides without affecting repository master data. Use for catalog or publication-specific adaptations.

Required parameters: id, class_id

POST /api/v3/record-asset/update-datas/repository/

update-datas/repository — Update repository asset attributes

Updates attribute values (simple and multiple types) of an existing asset in the repository (master data). Changes propagate to all projects where the asset is used, unless a local override exists.

Required parameters: id, class_id

POST /api/v3/record-asset/update-status/node/

update-status/node — Update project node status

Updates workflow status (LCA) of a project node. Optionally propagate to repository asset.

Required parameters: id, class_id, status_id

POST /api/v3/record-asset/update-status/repository/

update-status/repository — Update repository asset status

Updates workflow status (LCA) of a repository asset. Changes propagate to all projects unless overridden.

Required parameters: id, class_id, status_id

POST /api/v3/record-asset/update-type/

update-type — Change asset type

Reclassifies asset to a different type within the same class.

Required parameters: id, class_id, type_id

POST /api/v3/record-asset/upload-file/node/

upload-file/node — Upload file to project node

Attaches a physical file to a project-specific node. File exists only in this project context.

Required parameters: id, class_id

POST /api/v3/record-asset/upload-file/repository/

upload-file/repository — Upload file to repository asset

Attaches a physical file to a repository asset. File becomes available for all projects.

Required parameters: id, class_id

tasks

Tasks operations

Module spec: /openapi/tasks.json (5 endpoints)

POST /api/v3/tasks/create/

create — Create a task

Creates a task and returns it in full.

Required parameters: title

POST /api/v3/tasks/delete/

delete — Delete a task

Deletes a task (logical deletion) and removes it from the index and from the record it was attached to. Its attachments, comments and activity are kept in the database.

POST /api/v3/tasks/list/

list — Search tasks with filters and pagination

Returns the tasks the authenticated user is allowed to see, with filters, sorting and pagination.

POST /api/v3/tasks/update/

update — Update a task

Updates the provided fields of a task and returns it in full. Fields left out are untouched.

POST /api/v3/tasks/users/

users — List the users a task may be assigned to

Returns the users that can be set as responsible or in subscribers on the create and update endpoints: administrators, and users holding the « Accès aux tâches » permission, among the accounts placed in the users tree. It is the list the Tasks workspace proposes.

token

Authentication: obtain a JWT token by providing credentials (login/password), check token validity, or disable active tokens. A valid token is required in the Authorization header for all other API calls.

Module spec: /openapi/token.json (3 endpoints)

POST /api/v3/token/disable/

disable — Disable all active tokens

Invalidates all active JWT tokens for the account.

Required parameters: l

POST /api/v3/token/get/

get — Get JWT authentication token

Generates a JWT token for API authentication. Three grants are supported via "grant_type":

POST /api/v3/token/info/

info — Get current token information

Returns metadata about the current JWT token (validity, issue date, expiration).

types

Manage asset types (categories) within a library: create types, update properties, configure status assignments and set group permissions. Types define the classification and permission structure for assets.

Module spec: /openapi/types.json (8 endpoints)

POST /api/v3/types/assign-attributes/

assign-attributes — Sync attribute assignments for a type (add, update, remove)

Synchronizes which attributes are assigned to a record type, along with per-attribute display options. Send the complete desired state for this type: the endpoint computes a diff and applies additions, updates, and removals automatically.

Required parameters: id, assignments

POST /api/v3/types/create/

create — Create a new type in a library

Creates a new asset type (category) in a library with full configuration. If a type with the same label already exists for the given supertype, it returns the existing type without creating a duplicate.

Required parameters: class_id, label, supertype_id

POST /api/v3/types/full/

full — Get all types with full details

Returns all asset types for a class with complete configuration including permissions, statuses, and display settings.

Required parameters: class_id

POST /api/v3/types/get/

get — Get asset type details

Returns complete asset type configuration including permissions, statuses, display settings, and file management options.

Required parameters: id

POST /api/v3/types/list/

list — List types by class

Returns the asset types of a library with their id, portable code, label, supertype and active status.

Required parameters: class_id

POST /api/v3/types/statuses/

statuses — Get type status assignments

Returns available workflow statuses for an asset type (includes inherited statuses from supertype).

Required parameters: id

POST /api/v3/types/update-permissions/

update-permissions — Update group permissions for a type

Manages group (LCA) permissions on an asset type. Controls which groups can create, edit, or view assets of this type. Type IDs are unique across all libraries.

Required parameters: id, mode, permissions

POST /api/v3/types/update/

update — Update an existing type in a library

Updates properties of an existing asset type (category). Only provided fields are modified — omitted fields remain unchanged.

Required parameters: id

workflows

Retrieve workflow configurations: list available workflows and get complete workflow definitions including states, transitions and rules. Supports both repository and project contexts.

Module spec: /openapi/workflows.json (5 endpoints)

POST /api/v3/workflows/full/node/

full/node — Get full workflows for project node

Returns all workflows for a project node with complete configuration details.

Required parameters: project_node_id, class_id

POST /api/v3/workflows/full/repository/

full/repository — Get full workflows for repository

Returns all workflows for the repository project with complete configuration details.

Required parameters: class_id

POST /api/v3/workflows/get/

get — Get workflow details

Returns complete workflow configuration including step groups hierarchy, steps with their actions, contributors, completeness rules, and notification settings.

Required parameters: id

POST /api/v3/workflows/list/node/

list/node — List workflows by project node

Returns the workflows attached to a specific project node, with their id, code, label, supertype and asset types — without their steps.

Required parameters: project_node_id, class_id

POST /api/v3/workflows/list/repository/

list/repository — List workflows for repository

Returns the workflows of the master repository (resolved automatically from class_id), with their id, code, label, supertype and asset types — without their steps.

Required parameters: class_id