Makini
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
User GuideAPI Reference
MCPPlatforms
User GuideAPI Reference
MCPPlatforms
Website
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
v4 (Latest)
  • v4 (Latest)
  • v3 (Legacy)
  1. Embed
  • System
    • Service health check
  • Accounts
    • List accounts
    • Create an account
    • Get an account
    • Update an account
  • Addresses
    • List addresses
    • Get an address
  • Assets
    • List assets
    • Create an asset
    • Get an asset
    • Update an asset
    • Set the status of an asset
  • Budgets
    • List budgets
    • Get a budget
  • Contacts
    • List contacts
    • Get a contact
  • Contracts
    • List contracts
    • Get a contract
  • Countries
    • List countries
    • Get a country
  • Currencies
    • List currencies
    • Get a currency
  • Customers
    • List customers
    • Create a customer
    • Get a customer
    • Update a customer
  • Employees
    • List employees
    • Get an employee
  • Invoices
    • List invoices
    • Create an invoice
    • Get an invoice
    • Update an invoice
    • Submit an invoice
    • Approve an invoice
    • Cancel an invoice
    • Set the status of an invoice
  • Locations
    • List locations
    • Create a location
    • Get a location
    • Update a location
  • Meters
    • List meters
    • Create a meter
    • Get a meter
  • Organizations
    • List organizations
    • Get an organization
  • Partners
    • List partners
    • Get a partner
  • Quotes
    • List quotes
    • Create a quote
    • Get a quote
    • Submit a quote
    • Cancel a quote
    • Convert a quote
  • Receipts
    • List receipts
    • Get a receipt
  • Units
    • List units
    • Get an unit of measure
  • Vendors
    • List vendors
    • Create a vendor
    • Get a vendor
    • Update a vendor
  • Query
    • Run a Makini Query Language (MQL) statement
  • Passthrough
    • Call the connected system’s own API with the connection’s credentials
  • Raw
    • List the raw tables synced for this connection
    • List the rows of one raw table
  • OAuth
    • Issue an access token (client_credentials, authorization_code or refresh_token)
    • Revoke a refresh token, and with it the access tokens issued from it (RFC 7009)
    • JSON Web Key Set for access-token verification
    • Authorization server metadata (RFC 8414)
  • MCP
    • List the platforms an MCP user can see and use
    • Resolve whether an MCP user may execute tools against a platform
    • The folded tool policy of this MCP user on a platform
    • Ask an administrator for a tool this MCP user is denied
    • List the tool catalogue of a platform for this user
    • Execute one MCP tool against a platform for this user
  • Writes
    • Fetch the record of a queued write
  • Work Orders
    • Update a work order’s status (legacy alias of the set-status action)
    • Fetch the record of a queued write (legacy alias of GET /v4/writes/{writeId})
    • List work orders
    • Create a work order
    • Get a work order
    • Update a work order
    • Delete a work order
    • Assign a work order
    • Accept a work order
    • Reject a work order
    • Start a work order
    • Hold a work order
    • Resume a work order
    • Complete a work order
    • Close a work order
    • Cancel a work order
    • Set the status of a work order
    • Convert a work order
  • Taxonomies
    • List taxonomies
    • Get a taxonomy
  • Business Units
    • List business units
    • Get a business unit
  • Users
    • List users
    • Get an user
  • Labor Resources
    • List labor resources
    • Get a labor resource
  • Asset Assignments
    • List asset assignments
    • Create an asset assignment
    • Get an asset assignment
    • Update an asset assignment
    • Complete an asset assignment
  • Meter Readings
    • List meter readings
    • Create one or many meter readings
    • Get a meter reading
  • Alarms
    • List alarms
    • Get an alarm
    • Close an alarm
  • Dispense Transactions
    • List dispense transactions
    • Create one or many dispense transactions
    • Get a dispense transaction
    • Update a dispense transaction
    • Delete a dispense transaction
  • Work Requests
    • List work requests
    • Create a work request
    • Get a work request
    • Approve a work request
    • Reject a work request
    • Cancel a work request
    • Set the status of a work request
  • Work Tasks
    • List work tasks
    • Get a work task
    • Update a work task
    • Complete a work task
  • Maintenance Templates
    • List maintenance templates
    • Get a maintenance template
  • Maintenance Triggers
    • List maintenance triggers
    • Get a maintenance trigger
  • Events
    • List events
    • Get an event
  • Event Recurrences
    • List event recurrences
    • Get an event recurrence
  • Order Materials
    • List order materials
    • Create an order material
    • Get an order material
    • Update an order material
  • Order Resources
    • List order resources
    • Create an order resource
    • Get an order resource
    • Update an order resource
  • Comments
    • List comments
    • Create one or many comments
    • Get a comment
  • Inventory Items
    • List inventory items
    • Create an inventory item
    • Get an inventory item
    • Update an inventory item
  • Stock Levels
    • List stock levels
    • Get a stock level
  • Supply Options
    • List supply options
    • Get a supply option
  • Purchase Orders
    • List purchase orders
    • Create a purchase order
    • Get a purchase order
    • Update a purchase order
    • Submit a purchase order
    • Approve a purchase order
    • Receive a purchase order
    • Close a purchase order
    • Cancel a purchase order
    • Reopen a purchase order
    • Set the status of a purchase order
    • Convert a purchase order
  • Purchase Order Lines
    • List purchase order lines
    • Get a purchase order line
  • Invoice Lines
    • List invoice lines
    • Get an invoice line
  • Budget Lines
    • List budget lines
    • Get a budget line
  • Work Centers
    • List work centers
    • Get a work center
  • Production Routings
    • List production routings
    • Get a production routing
  • Production Routing Operations
    • List production routing operations
    • Get a production routing operation
  • Bills Of Material
    • List bills of material
    • Get a bill of material
  • Bill Of Material Lines
    • List bill of material lines
    • Get a bill of material line
  • Production Orders
    • List production orders
    • Create a production order
    • Get a production order
    • Update a production order
    • Delete a production order
    • Start a production order
    • Reopen a production order
    • Close a production order
  • Production Order Operations
    • List production order operations
    • Get a production order operation
  • Purchase Requisitions
    • List purchase requisitions
    • Create a purchase requisition
    • Get a purchase requisition
    • Submit a purchase requisition
    • Approve a purchase requisition
    • Reject a purchase requisition
    • Cancel a purchase requisition
    • Convert a purchase requisition
  • Purchase Requisition Lines
    • List purchase requisition lines
    • Get a purchase requisition line
  • Quote Lines
    • List quote lines
    • Get a quote line
  • Sales Orders
    • List sales orders
    • Create a sales order
    • Get a sales order
    • Update a sales order
    • Ship a sales order
    • Close a sales order
    • Cancel a sales order
    • Reopen a sales order
    • Set the status of a sales order
    • Convert a sales order
  • Sales Order Lines
    • List sales order lines
    • Get a sales order line
  • Return Orders
    • List return orders
    • Get a return order
  • Return Order Lines
    • List return order lines
    • Get a return order line
  • Shipments
    • List shipments
    • Create a shipment
    • Get a shipment
    • Complete a shipment
  • Shipment Lines
    • List shipment lines
    • Get a shipment line
  • Receipt Lines
    • List receipt lines
    • Get a receipt line
  • Inventory Transactions
    • List inventory transactions
    • Create one or many inventory transactions
    • Get an inventory transaction
  • Leases
    • List leases
    • Get a lease
  • Lease Applications
    • List lease applications
    • Get a lease application
  • Projects
    • List projects
    • Get a project
  • Inventory Documents
    • List inventory documents
    • Create an inventory document
    • Get an inventory document
    • Post an inventory document
    • Cancel an inventory document
  • Checklists
    • List checklists
    • Get a checklist
  • Checklist Items
    • List checklist items
    • Get a checklist item
  • Attachments
    • List attachments
    • Create an attachment
    • Get an attachment
    • Delete an attachment
  • Management API
    • Connections
      • List connections
      • Create a connection (real with credentials, or intended)
      • Get one connection
      • Update a connection
      • Soft-delete a connection
      • Permanently delete a connection
      • Activate or deactivate a connection (inactive is refused by /v4, MCP and sync, but is not a deletion)
      • The forms, solutions and flow folders of a connection, and which are on
      • Set exactly which forms, solutions and flow folders are on for a connection
      • Issue a connection-scoped access token for one of your connections
    • Embed
      • Mint a short-lived embed session for a connection’s settings form
        POST
      • Read the settings an end user saved for a connection
        GET
      • Store an end user’s submitted settings (first-party only)
        PUT
      • Flip the end user’s kill switch for a connection’s settings form (first-party only)
        PUT
      • Disconnect a connection from inside the embed (first-party only)
        POST
      • Read the form a custom-modal field's endpoint defines (first-party only)
        POST
      • One page of a connection’s support requests (first-party only)
        GET
      • Open a support request for a connection (first-party only)
        POST
      • One support request and its public thread (first-party only)
        GET
      • Reply to a support request (first-party only)
        POST
      • One file from a support request (first-party only)
        GET
      • Open one of your customers’ embedded experience: their connections, connecting another, each connection’s forms
        POST
      • Resolve an embed session token into everything the embed renders (first-party only)
        GET
      • List the client’s embed settings forms
        GET
      • Read one of the client’s embed settings forms
        GET
      • Create or replace one of the client’s embed settings forms
        PUT
      • Delete one of the client’s embed settings forms, with every connection’s answers to it
        DELETE
    • Clients
      • Register a management-layer OAuth client and issue its first secret
      • List clients, optionally filtered by exact email
      • Get one client, with its redirect URIs and its secrets’ metadata
      • Update a client’s name, email or logos
    • Secrets
      • Generate a new client secret
      • Read a secret value (decrypted)
      • Revoke a secret (soft delete)
    • Redirect URIs
      • Add a redirect URI to a client
      • Replace the value of a redirect URI
      • Delete a redirect URI
    • Whitelabel
      • Replace a client’s Makini Link whitelabel config
      • Clear a client’s Makini Link whitelabel config
    • Log Retention
      • Set how long a client’s API request log is kept
    • Webhook Endpoints
      • List a client’s outbound webhook endpoints
      • Register an outbound webhook endpoint
      • Update an outbound webhook endpoint
      • Delete an outbound webhook endpoint
      • The outbound webhook delivery log
    • Support
      • One page of an application’s support requests, from its team and its end users
      • Open a support request for an application, as a named member
      • One of an application’s support requests and its public thread
      • Reply to an application’s support request, as a named member
      • One file from an application’s support request
      • Store one file for a later support request or reply
    • Platforms
      • The platforms your application can connect
    • Compat
      • v1 compatibility: GET /api/system/platforms (temporary, removed at the end of November 2026)
      • v1 compatibility: GET /api/system/connections (temporary, removed at the end of November 2026)
      • v1 compatibility: POST /api/system/connections (temporary, removed at the end of November 2026)
      • v1 compatibility: POST /v1/embed/session (temporary, removed at the end of November 2026)
    • Field Mappings
      • Read a connection’s field mappings: what it serves and the active mapping document
      • Save a connection’s field mappings as a new revision
      • List a connection’s field-mapping revisions, newest first
      • Activate an earlier field-mapping revision
      • Replace a connection’s custom streams
      • Test-fetch a (possibly unsaved) custom stream against the live vendor endpoint
      • Read the source tables and columns a connection’s mappings can use
    • Data Mappings
      • List the entities of a connection that are mapped to the customer’s own identifiers
      • Start mapping one entity of a connection
      • Read one data mapping’s definition
      • Change a data mapping’s cardinality
      • Stop mapping an entity, discarding its pairs
      • Read one page of a data mapping’s pairs
      • Replace a data mapping’s pairs wholesale
    • MCP
      • Create an MCP role (first-party only)
      • List a client’s MCP roles (first-party only)
      • Update an MCP role (first-party only)
      • Delete an MCP role, optionally reassigning its users (first-party only)
      • List end customers
      • Register an end customer
      • Which metadata key names a connection’s end customer
      • Set the metadata key that names a connection’s end customer
      • One customer, with its counts
      • Rename a customer, or re-point the provider’s identifier for them
      • Remove one of the provider’s customers
      • List one customer’s MCP users
      • Provision an MCP user for one of the provider’s customers
      • Update one of a customer’s MCP users
      • Offboard one of a customer’s MCP users
      • Read one of a customer’s MCP users
      • Mint a personal access token for one of a customer’s MCP users
      • List the personal access tokens of one of a customer’s MCP users
      • End one personal access token of one of a customer’s MCP users
      • Connect a platform for one of a customer’s agents
      • List one customer’s connections
      • List one customer’s MCP roles
      • Create a role for one customer
      • Rename a customer’s role, or make it their default
      • Delete a customer’s role, optionally reassigning its users
      • Read one of a customer’s MCP roles
      • What one customer sees, and what it inherits
      • Which platforms a customer has company-wide credentials for
      • What to send for a customer’s company-wide credentials, and what is stored
      • Set one customer’s company-wide credentials for a platform
      • Stop supplying a customer’s company-wide credentials for a platform
      • What one customer has set up: every platform on for it, its sign-in choice, and what it stored
      • The customer’s live setup link, if any — who it went to and when it dies, never the code
      • Mint the customer’s setup link, replacing a live one
      • Revoke the customer’s live setup link
      • Record whom the live setup link was emailed to
      • The customer’s choice for one platform: one shared account for everyone, or each person from their agent
      • Remove the customer’s sign-in to one platform: its shared account, its API key or its company-wide fields
      • What one of a customer’s roles may call on a platform
      • Set a page of tool permissions for one of a customer’s roles
      • Enable or disable every tool on a platform for one of a customer’s roles
      • Override, or clear, one platform for one customer
      • Create an MCP user (first-party only)
      • List a client’s MCP users (first-party only)
      • Update an MCP user (first-party only)
      • Soft-delete an MCP user (first-party only)
      • Give a pending MCP user its seat (first-party only)
      • Issue a personal access token for an agent (first-party only)
      • List an agent’s personal access tokens (first-party only)
      • End one of an agent’s personal access tokens (first-party only)
      • Connect a platform for an agent (first-party only)
      • Read a client’s platform visibility (first-party only)
      • Set the platform-visibility default, and optionally the decided platforms (first-party only)
      • Show or hide one platform (first-party only)
      • The workspace’s third-party MCP servers: catalog and custom (first-party only)
      • Register a custom MCP server by URL (first-party only)
      • Edit a custom MCP server (first-party only)
      • Remove an MCP server from the workspace (first-party only)
      • Start an OAuth sign-in to a third-party MCP server: the workspace's or one person's (first-party only)
      • Sign in to the server now and load its tool list (first-party only)
      • List an adapter’s tool catalogue, searched and paginated (first-party only)
      • One level’s guardrail rules on a platform, every tool (first-party only)
      • Replace one tool’s guardrail rules at one level (first-party only)
      • Relabel a tool or rewrite its description for this workspace (first-party only)
      • List the platforms a client has company-wide credentials for (first-party only)
      • Read one platform’s company-wide credential form and state (first-party only)
      • Set a platform’s company-wide credentials (first-party only)
      • Clear a platform’s company-wide credentials (first-party only)
      • Read the tool policy for a page of tool names (first-party only)
      • Write the tool policy for a page of tool names (first-party only)
      • Flip one level’s tool-policy default, wiping its exceptions (first-party only)
      • Access requests of the workspace, newest first (first-party only)
      • Grant a pending access request to the person or their role (first-party only)
      • Dismiss a pending access request (first-party only)
  1. Embed

Resolve an embed session token into everything the embed renders (first-party only)

GET
https://api.makini.io/v4/embed/sessions/{token}

Request

Path Params

Responses

🟢200OK
application/json
Either the whole embed view, or {status:"expired", embed:null}. An expired link is a normal product state and is NOT folded into the 404: the end user’s next step differs ("ask for a fresh link" vs "this address was never valid").
Bodyapplication/json

🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.makini.io/v4/embed/sessions/'
Response Response Example
200 - Example 1
{
    "status": "active",
    "embed": {
        "session": {
            "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
            "connectionId": "84b500d7-71c8-4b1f-adf4-f1eb0000973d",
            "tenantId": "string",
            "expiresAt": "2019-08-24T14:15:22.123Z"
        },
        "client": {
            "name": "string",
            "whitelabel": {
                "theme": {
                    "background": "string",
                    "foreground": "string",
                    "surface": "string",
                    "card": "string",
                    "muted": "string",
                    "mutedForeground": "string",
                    "border": "string",
                    "primary": "string",
                    "primaryForeground": "string",
                    "ring": "string"
                },
                "customCss": "string",
                "embed": {
                    "radius": "string",
                    "fontFamily": "string"
                },
                "background": {
                    "imageUrl": "string",
                    "repeat": "no-repeat",
                    "position": "center"
                },
                "panel": {
                    "transparency": 0,
                    "blur": 0
                }
            },
            "logoSquareUrl": "http://example.com",
            "logoWideUrl": "http://example.com"
        },
        "connection": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "name": "string",
            "email": "user@example.com",
            "userMetadata": {
                "property1": "string",
                "property2": "string"
            },
            "platform": {
                "key": "string",
                "name": "string",
                "logoUrl": "string"
            },
            "connectedAt": "2019-08-24T14:15:22.123Z",
            "deactivatedAt": "2019-08-24T14:15:22.123Z",
            "credentialsExpiredAt": "2019-08-24T14:15:22.123Z"
        },
        "form": {
            "key": "string",
            "name": "string",
            "isDefault": true,
            "version": 0,
            "formEnabled": true,
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z",
            "schema": {
                "version": 0,
                "groups": [
                    {
                        "id": "string",
                        "key": "string",
                        "name": "string",
                        "hasToggle": true,
                        "fields": [
                            {
                                "id": "string",
                                "key": "string",
                                "type": "string",
                                "label": "string",
                                "property1": "string",
                                "property2": "string"
                            }
                        ],
                        "property1": "string",
                        "property2": "string"
                    }
                ]
            },
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"
        },
        "settings": {
            "property1": {
                "property1": "string",
                "property2": "string"
            },
            "property2": {
                "property1": "string",
                "property2": "string"
            }
        },
        "formEnabled": true,
        "solutions": [
            {
                "slug": "string",
                "name": "string",
                "baseUrl": "string",
                "readKey": "string",
                "tables": [
                    {
                        "key": "string",
                        "label": "string",
                        "columns": [
                            {
                                "key": "string",
                                "label": "string",
                                "type": "text"
                            }
                        ],
                        "search": true,
                        "byConnection": true,
                        "showIn": [
                            "dashboard"
                        ],
                        "embed": {
                            "label": "string",
                            "columns": [
                                "string"
                            ]
                        }
                    }
                ]
            }
        ]
    },
    "home": {
        "session": {
            "clientId": "5e505642-9024-474d-9434-e5a44f505cc5",
            "expiresAt": "2019-08-24T14:15:22.123Z",
            "open": {
                "property1": "string",
                "property2": "string"
            }
        },
        "client": {
            "name": "string",
            "whitelabel": {
                "theme": {
                    "background": "string",
                    "foreground": "string",
                    "surface": "string",
                    "card": "string",
                    "muted": "string",
                    "mutedForeground": "string",
                    "border": "string",
                    "primary": "string",
                    "primaryForeground": "string",
                    "ring": "string"
                },
                "customCss": "string",
                "embed": {
                    "radius": "string",
                    "fontFamily": "string"
                },
                "background": {
                    "imageUrl": "string",
                    "repeat": "no-repeat",
                    "position": "center"
                },
                "panel": {
                    "transparency": 0,
                    "blur": 0
                }
            },
            "logoSquareUrl": "http://example.com",
            "logoWideUrl": "http://example.com"
        },
        "endCustomer": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "externalId": "string",
            "name": "string"
        },
        "access": {
            "connect": true,
            "reconnect": true,
            "disconnect": true,
            "activity": true,
            "support": true,
            "chooseInLink": true
        },
        "connections": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "name": "string",
                "platform": {
                    "key": "string",
                    "name": "string",
                    "logoUrl": "string"
                },
                "connectedAt": "2019-08-24T14:15:22.123Z",
                "deactivatedAt": "2019-08-24T14:15:22.123Z",
                "credentialsExpiredAt": "2019-08-24T14:15:22.123Z",
                "features": [
                    {
                        "kind": "form",
                        "key": "string",
                        "name": "string",
                        "description": "string",
                        "turnOn": "auto",
                        "available": true,
                        "on": true
                    }
                ]
            }
        ]
    }
}
Modified at 2026-10-16 14:17:58
Previous
Open one of your customers’ embedded experience: their connections, connecting another, each connection’s forms
Next
List the client’s embed settings forms
Built with