Available API calls for the /discos path are summarized here. To see the headers, response, parameters, and behavior, please click the link for the API call document.
For more information about the RMap DiSCO object format, please visit the DiSCO media type document.
| HTTP Method | API Path | Title | Description |
|---|---|---|---|
| OPTIONS | /discos | Explain RMap DiSCO Service | Provides a link to the API documentation and a list of available HTTP verbs for the /discos path. |
| HEAD | /discos | RMap DiSCO Service Status | Provides a link to API documentation and a list of available HTTP verbs for the /discos path. |
| POST | /discos | Create an RMap DiSCO | Creates a new RMap DiSCO. |
| HEAD | /discos/{uri} | View RMap DiSCO Status | Retrieve status and version information for referenced DiSCO. |
| GET | /discos/{uri} | Retrieve RMap DiSCO | Retrieve DiSCO. For versioning, this path is considered to be a DiSCO "Memento" - a snapshot of the DiSCO in time. |
| GET | /discos/{uri}/latest | Retrieve Latest Version of DiSCO | Returns redirect response to the path of the latest version of the DiSCO. |
| POST | /discos/{uri} | Update an RMap DiSCO | Updates an existing DiSCO. Performs differently depending on the updater is the original creator of the DiSCO. |
| POST | /discos/{uri}/inactivate | Inactivate an RMap DiSCO | Sets the status of an existing DiSCO to inactive. Inactive DiSCOs are still publicly available for read access. |
| DELETE | /discos/{uri} | Soft Delete ("tombstone") an RMap DiSCO | Sets the status of an existing DiSCO to tombstoned. Tombstoned DiSCOs are not publicly available for read access, but their data still exists in the RMap triplestore. |
| GET | /discos/{uri}/allversions | Retrieve DiSCO Versions (any Agent) | Retrieves a list of DiSCO URIs that are versions and derivatives of the DiSCO referenced. |
| GET | /discos/{uri}/agentversions | Retrieve DiSCO Versions (same Agent) | Retrieves a list of DiSCO URIs that are versions of the DiSCO referenced and created by the same RMap Agent. |
| GET | /discos/{uri}/timemap | Retrieve DiSCO versions (same Agent) as Memento Timemap | Retrieves list of DiSCO version API URLs that were created by the same RMap Agent in the Memento Timemap format. |
| GET | /discos/{uri}/events | Retrieve DiSCO Events | Retrieves a list of Event URIs for Events that have affected the DiSCO referenced. |