Get a list of resources you have access to

get

https://example.com/resources

As it is not possible to choose your own resource identifier and thus include semantics in the URI of a resource, it is essential that you are able to discover which resources you have access to.

Using this endpoint, you can get an list of all the resources you have access to given a Solid token. The metadata that is provided, should enable you to use these resources in your application.

Notes:

Currently, it is not yet possible to filter on subject or type. For now, this must be done client-side.
Metadata returned by this endpoint is eventually consistent with the actual data.

Headers

X-Request-ID

string

If provided, this string will be set as the value of the X-Request-ID response header.

X-Correlation-ID

string

If provided, this string will be set as the value of the X-Correlation-ID response header.

Authorization

string

A DPoP bound Solid JWT token containing at least three claims: sub, azp and iss.

DPoP

string

The DPoP proof for the Solid JWT token, endpoint and http method.

Purpose

string

A comma separated list of URIs that identify the purposes for which data is being read. For example https://dbpedia.org/marketing/, https://dbpedia.org/direct-mailing/. Depending on the tenant, this field can be required or not.

Legal-Basis

string

A comma separated list of URIs that identify the legal bases for which data is being read. For example https://w3id.org/dpv#PublicInterest. Depending on the tenant, this field can be required or not.

Origin

string

If provided, this value will be used in the reponse to enable cross origin resource sharing.

Responses

`purpose_header_required_but_not_present`
`purpose_header_invalid`
`legal_basis_header_required_but_not_present`
`legal_basis_header_invalid`
`origin_header_not_valid`
`x_correlation_id_invalid`
`x_request_id_invalid`

`conditional_http_requests_not_yet_supported`

200OK

400Bad Request Possible error codes: purpose_header_required_but_not_present purpose_header_invalid legal_basis_header_required_but_not_present legal_basis_header_invalid origin_header_not_valid x_correlation_id_invalid x_request_id_invalid

401Unauthorized

500Internal Server Error

501Not Implemented Possible error codes: conditional_http_requests_not_yet_supported

`purpose_header_required_but_not_present`
`purpose_header_invalid`
`legal_basis_header_required_but_not_present`
`legal_basis_header_invalid`
`origin_header_not_valid`
`x_correlation_id_invalid`
`x_request_id_invalid`

`conditional_http_requests_not_yet_supported`