PROV Storage Web Service

All paths below are relative to the endpoint: https://pennprovenance.net/prov.

Almost all requests require a signature for authentication.

Resource Paths

• /tokens
  • POST /tokens: Create a session token for authentication.
  • DELETE /tokens/{sessionKey}: Delete the session token with the given sessionKey
• /documents
  • GET /documents: Get list of user's PROV documents.
  • GET /documents/{docId}: Get info about a document.
  • PATCH /documents/{docId}: Modify info about a document.
  • POST /documents/content: Upload a document.
  • GET /documents/{docId}/content: Download a document.
  • DELETE /documents/{docId}: Delete a document.
  • GET /documents/{docId}/types: Get list of types contained in a document.
  • GET /documents/{docId}/relations: Get list of relations contained in a document.
• /types
  • GET /types: Get list of user's PROV types, i.e., Entities, Agents, and Activities.
  • GET /types/{typeId}: Get info about a type.
  • GET /types/{typeId}/relations: Get info about the relations in which a type takes part.
  • GET /types/provid: Search for types by PROV identifier.
• /relations
  • GET /relations: Get list of user's PROV relations, e.g., Derivations, Generations, ...
  • GET /relations/{relationId}: Get info about a relation.
• /users
  • GET /users: Get list of all users (admin only)
  • POST /users: Create a new user.
  • GET /users/{userId}: Get user info.
  • PATCH /users/{userId}: Modify a user's info.