Personium REST API Reference

Welcome to the Personium REST API Reference.
The REST API Reference describes technical detailed specifications related to all of the REST APIs provided by Personium.

Unit Level API

The Unit Level API is an API belonging to the unit that hosts a group of cells (for creating cells and managing a group of created cells).
In principle, these APIs cannot be accessed using the access tokens issued from the cell.
(They are available after promotion to unit level tokens)

Resource Path

https://{UnitFQDN}/

Create/Register
Acquire
Update
Delete
Other
Cell Create Acquire List
Acquire
Update Delete
Recursive Delete

UUT



Upgrade setting


Cell Level API

Resource Path

https://{UnitFQDN}/{CellName}
Cell internal setting API: setting in single cell model

Create/Register
Acquire
Update
Delete
Role Register Acquire List
Acquire
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire

Account Register Acquire List
Acquire
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire

Box Create Acquire
Acquire List
Acquire URL
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire

Authentication

Change Password
Social Coordination APIs: Multiple cell model configuration

Create/Register
Acquire
Update
Delete
Other
ExtCell Register Acquire List
Acquire
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire List


Relation Register Acquire List
Acquire
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire


ExtRole Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp Register Acquire


Authentication
(/__auth, /__authz)




OAuth2_Authorization end point
OAuth2Token_Endpoint Authentication
Access Control Restrict Acquire Properties Change Properties

Events Accept Event Log File Acquire
Log File Acquire List
Log File Acquire Information

Delete Log File
Message Control
Transmit

Acquire
Acquire List

Delete
Message Control
Receive

Acquire
Acquire List
Change Status Delete


Box Level API

Resource Path (* with certain exceptions)

https://{UnitFQDN}/{CellName}/{BoxName}
https://{UnitFQDN}/{CellName}/{BoxName}/{ResourcePath}
Box Management
Create/Register
Acquire
Install Box Acquire Box Meta Data
WebDAV

Create/Register
Acquire
Update
Delete
Other
Collection Create Acquire Settings Change Settings
Move/Rename
Delete
File Register/Update Acquire
Acquire Settings
Change Settings Delete
Access Control



Configuring the Settings
OData

Create/Register
Acquire
Update
Delete
Other
EntityType Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List Update Delete
  _via NavProp
Acquire List


AssociationEnd Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List
Delete
  _via NavProp
Acquire List


ComplexType Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List Update Delete
Property Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List Update Delete
ComplexTypeProperty Register Acquire
Acquire List
Update Delete
  _$links Register Acquire List Update Delete
Entity Create Acquire
Acquire List
Update
Partial Update
Delete Batch Operation
  _$links
Register Acquire List Update Delete
  _via NavProp Register Acquire List


Server Script (Engine Service Collection)

Create/Register
Acquire
Update
Delete
Other
Service Collection Source Create Acquire Apply Settings Delete Service Execute
Service Document Acquire/Schema Acquire

Acquire
Service Document Acquire
Schema Acquire
OData Acquisition Common Queries
Query Single Acquisition List Acquisition
$format Query Yes Yes
$expand Query Yes Yes
$select Query Yes Yes
$orderby Query Yes Yes
$top Query Yes Yes
$skip Query Yes Yes
$filter Query Yes Yes
$inlinecount Yes Yes
Full-text Search (q) Query Yes Yes


Common

Error Messages

Restrictions on personium HTTP Implementation

CORS Support

Cross Domain Policy File Acquire


Glossary