Skip to main content

​
About Presidio

Presidio is an IT solutions and services provider. Serval connects to Presidio’s Procurement API to read dispatched-asset records, stock levels, and serial numbers on your behalf whenever a Serval workflow runs. Authentication: An API username and password issued by Presidio, plus the exact User-Agent value Presidio assigned to your account. Serval exchanges the username and password for a short-lived JWT at Presidio’s token endpoint and sends the JWT (as a bearer token) together with your User-Agent value on every request. The User-Agent is required because Presidio’s gateway blocks any request — including authentication — that does not carry the expected value. Regions: Presidio publishes two regional API families from the same host: EMEA (/api/v1/emea/..., including stock and serial-number endpoints) and APAC - Singapore (/api/v1/apac/singapore/..., assets only). Your credentials determine which region you can read; workflows choose the region by endpoint path. Data sync: On-demand only - there is no background sync or scheduled ingestion. Serval reads from Presidio at the moment a Serval workflow runs.

​
What the Presidio integration enables

​
Get your credentials

Presidio issues API credentials directly — there is no self-service developer portal. Ask your Presidio account contact for:
1

API username and password

The login pair for the Procurement API’s token endpoint.
Treat the password like any other credential. If it’s ever exposed, ask Presidio to rotate it and update the Serval connection.
2

Your User-Agent value

The exact User-Agent string Presidio assigned to your account, e.g. ProcurementAPI/1.0 (custom;yourcompany). Presidio’s gateway rejects requests that do not send it, so it must be copied exactly.

​
Connect in Serval

All fields are required. An incomplete configuration is rejected with a message beginning “Invalid Presidio configuration”.
1

Enter the Username

The API login Presidio issued for your account.
2

Enter the Password

The API password Presidio issued alongside the username.
3

Enter the User-Agent

The exact User-Agent value from Presidio, copied character-for-character.
After connecting, Serval runs healthchecks that authenticate and read a one-item sample from the assets API (trying EMEA first, then APAC - Singapore). The stock and serial-number checks apply to EMEA accounts only and are expected to fail for APAC - Singapore accounts.