Snapshot version

You are browsing the docs for the snapshot version of Nexus, the latest release is available here

History of resources

The history endpoint allows to get an overview of the differents events and actions which occured during the lifetime of a resource (creation/update/tag/deprecation) for the different types of resources (generic resources, schemas, files).

Authorization notes

When performing a request, the caller must have resources/read permission on the project the resource belongs to.

Please visit Authentication & authorization section to learn more about it.

Note

The described endpoints are experimental and the responses structure might change in the future.

GET /v1/history/{org_label}/{project_label}/{id}

where…

  • {id}: the identifier of the resource to resolve (URL encoded value).

Example

Request
sourcecurl "http://localhost:8080/v1/org/project/https%3A%2F%2Fexample.com%2FAlice"
Response
source{
  "_total": 2,
  "_results": [
    {
      "@id": "https://example.com/Alice",
      "@type": [
        "http://schema.org/Person"
      ],
      "action": [
        "Created"
      ],
      "organization": "org",
      "project": "org/project",
      "rev": 1,
      "subject": {
        "@type": "User",
        "realm": "realm",
        "subject": "user"
      }
    },
    {
      "@id": "https://example.com/Alice",
      "@type": [
        "http://schema.org/Person"
      ],
      "action": [
        "Tagged"
      ],
      "instant": "1970-01-01T00:00:00Z",
      "organization": "org",
      "project": "org/project",
      "rev": 2,
      "subject": {
        "@type": "User",
        "realm": "realm",
        "subject": "user"
      }
    }
  ]
}