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/resources/{org_label}/{project_label}/{id}

where…

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

Example

Request
sourcecurl "http://localhost:8080/v1/history/resources/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"
      }
    }
  ]
}
v1.11.x