For Agents
Retrieve a document file from the Administrate Document Management System by ID. The endpoint is read-only and exposes one operation; the API is deprecated, so use it only for legacy integrations.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Administrate DMS API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Administrate DMS API.
Retrieve a single DMS document by its identifier for legacy training-record exports
Pull historical course attachments out of Administrate during a migration to the newer GraphQL API
Mirror legacy training documents into a separate document store before the DMS retires
GET STARTED
Use for: Retrieve a training document by ID from Administrate, Get a course attachment file from Administrate DMS, Check whether a legacy DMS document still exists, Download a learner certificate stored in Administrate
Not supported: Does not handle course management, learner enrolment, or document upload — use only for read-by-ID retrieval of legacy DMS documents during migration or audit workflows.
Jentic publishes the only available OpenAPI specification for Administrate DMS API, keeping it validated and agent-ready. Administrate is a training management platform for corporate learning and external training providers, and the DMS (Document Management System) API is its legacy interface for retrieving documents attached to courses, events, or learners. The current API exposes a single read endpoint for fetching a document by ID. Note: this API is deprecated and scheduled for retirement, so production agents should plan a migration to Administrate's newer GraphQL platform.
Verify a stored document ID still resolves before decommissioning a training catalogue entry
Patterns agents use Administrate DMS API for, with concrete tasks.
★ Legacy Document Retrieval
Training providers running long-lived Administrate accounts often hold thousands of attachments in the legacy DMS. The API's single endpoint allows automated retrieval of a document by ID so historical records can be exported during audits or system migrations. Each call returns one document, so retrieval is typically driven by a list of IDs collected elsewhere.
Given a list of DMS document IDs from a CSV, call `GET /api/v2/docs/dms/{id}` for each ID and store the returned file in a destination bucket.
Pre-Migration Document Mirror
Organisations migrating from the deprecated DMS to Administrate's newer platform need a verified copy of every existing document before the legacy endpoint retires. The DMS API supplies the binary content per document, allowing a one-time mirror into another document store keyed by Administrate ID.
Iterate over a manifest of DMS IDs, call `GET /api/v2/docs/dms/{id}` for each, and write the file plus its metadata to a backup location.
Audit-Driven Spot Check
When auditors request a specific training certificate or course attachment, the DMS API can fetch it on demand without exposing a human user to the Administrate console. The single document endpoint is sufficient for ad-hoc retrieval during compliance reviews.
Given a document ID supplied by an auditor, call `GET /api/v2/docs/dms/{id}` and return the file contents as the audit response.
Agent-Driven Legacy Lookup
An AI agent helping a learning operations team answer document-recovery questions can use Jentic to discover the DMS retrieval operation and fetch any document by ID without manual API plumbing. Because the API is deprecated, the agent should also flag results so the team can plan migration off the endpoint.
Resolve a learner's request for a specific certificate by calling the DMS document endpoint via Jentic and returning the file along with a deprecation notice for the operations team.
1 endpoints — jentic publishes the only available openapi specification for administrate dms api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/v2/docs/dms/{id}
Get a DMS document by ID
/api/v2/docs/dms/{id}
Get a DMS document by ID
Three things that make agents converge on Jentic-routed access.
Credential isolation
Administrate Basic Auth credentials are stored encrypted in the Jentic vault. Agents call the DMS document operation via Jentic and the platform injects the `Authorization: Basic …` header — the raw username and password never enter the agent's context.
Intent-based discovery
Agents search Jentic by intent (e.g. 'retrieve a training document from Administrate') and Jentic returns the DMS document operation with its input schema, so the agent can call it without reading the deprecated docs.
Time to first call
Direct Administrate DMS integration: an hour or two for a one-off retrieval script. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Administrate DMS API through Jentic.
Why is there no official OpenAPI spec for Administrate DMS API?
Administrate does not publish a current OpenAPI specification for the legacy DMS endpoint. Jentic generates and maintains this spec so that AI agents and developers can call Administrate DMS API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Administrate DMS API use?
The DMS API uses HTTP Basic Authentication. Through Jentic, the credential pair is stored encrypted and injected at execution time — agents never receive the raw username and password.
Can I retrieve any document by ID with the Administrate DMS API?
Yes, but only one document per call. Use `GET /api/v2/docs/dms/{id}` to fetch a single document. To export many, iterate over a list of IDs collected from elsewhere.
How do I retrieve a DMS document through Jentic?
Search Jentic for `retrieve a document from Administrate DMS`, load the schema for `GET /api/v2/docs/dms/{id}`, and execute with the document ID. Jentic injects the Basic Auth header from the vault.
Is the Administrate DMS API still supported?
No — Administrate marks this API as deprecated and scheduled for retirement. Use it for legacy retrieval and migration only, and plan to move to Administrate's newer platform for ongoing integrations.
Does this API let me upload documents to Administrate?
No. The DMS API surface here is read-only and exposes a single GET-by-ID endpoint. For upload or course management, use Administrate's primary platform API.