{"info":{"_postman_id":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","name":"Curator API V1 (1.0)","description":"
\n

Welcome to Curator API

The Curator REST API enables you to interact with Curator programmatically. Use this API to build apps, script interactions with Curator, or develop any other type of integration. This page documents the REST resources currently available in Curator API, including the HTTP response codes and example requests and responses.

OpenAPI

OpenAPI Specification is an API description format for REST APIs. Curator REST API conforms to OpenAPI 3.0 Specification.

Curator REST OpenAPI specification can be downloaded using the link above and imported into tools such as Postman for testing or Swagger Codegen for SDK code generation.

Schema

All API access is accessed from https://[host]/CuratorGateway/api/v1. All data is sent and received as JSON.

Blank fields are included as null instead of being omitted.

All timestamps return in ISO 8601 format and are UTC without timezone information:

YYYY-MM-DDTHH:MM:SSZ

Version and URI

This documentation is for version 1 of the Curator REST API, which is the latest version.

The URIs for resources have the following structure:

https://[host]/CuratorGateway/api/v1/

For example, https://[host]/CuratorGateway/api/v1/assets/00000000000000000000000001162429

Root Endpoint

You can issue a GET request to the root endpoint to get all the endpoint categories that the Curator REST API v1 supports:

https://[host]/CuratorGateway/api/v1

Hypermedia

All resources may have one or more href properties linking to other resources. These are meant to provide explicit URLs so that proper API clients don't need to construct URLs on their own. It is highly recommended that API clients use these. Doing so will make future upgrades of the API easier for developers. All URLs are expected to be proper RFC 6570 URI templates.

Such as:

{\n    \"href\": \"https://[host]/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/MyMetadataName\",\n    \"displayName\": \"My Metadata Name\",\n    \"values\": [\n        \"My Metadata Value\"\n    ],\n    \"type\": \"Text\",\n    \"name\": {\n        \"href\": \"https://[host]/CuratorGateway/api/v1/metadatanames/MyMetadataName\"\n    }\n}\n

Status Codes

The Curator REST API uses the standard HTTP status codes.

Operations that return an error status code may also return a response body containing details of the error or errors. The schema for each response code can be found under each API request.

OAuth2 Authentication

When interaction with the Curator API, your application will access Curator on behalf of your users.

Curator API uses OAuth 2.0, an open specification, to authorise access to a user's data and Curator API resources. The primary goal of OAuth is to allow developers to interact with Curator API without requiring them to store sensitive credentials.

Curator API supports common OAuth 2.0 scenarios such as those for web server, client-side, installed, and limited-input device applications.

Once complete, the OAuth flow returns an access token to your client application. This access token should be added to all Curator API requests in the Authorization HTTP header in this format Bearer [access token].

Registering a Client Application

In order for your application to request an access token on behalf of a user, you must first register it with Curator. This can be done via the Curator Gateway admin console (Authentication -> Clients).

Once you have registered your client application you will be issued a client_id.

API Resource Scopes

When you add your client application you will be asked which API Resources scopes that you client application needs access to. The selected scopes are applied to your access token and determine which API calls your application is allowed to execute. Each Curator API request below documents which API Resoure scopes are required.

Below is a list of example API resource scopes:

Curator.Server.API
Curator.Gateway.API
Curator.ProcessEngine.API

See the Authentication section below for a complete list of supported API resource scopes.

Authorisation Code Grant Type

In OAuth 2.0, the term “grant type” refers to the way an application gets an access token. OAuth 2.0 defines several grant types which Curator supports.

The Authorization Code is the recommended OAuth grant type for all applications. When you register your client application you can specifiy the supported grant types.

At a high level, the Authorisation Code flow has the following steps:

The client application makes a request to the authorize endpoint.
Curator redirects the user to the login screen.
The user is redirected back to the client application with an authorisation code in the query string.
The client application exchanges the authorisation code for an access token using the token endpoint.

Requesting an Access Token

To request an access token using the authorisation code grant type.

1. Make a GET request to the authorize endpoint.

https://[host]/CuratorGateway/connect/authorize?client_id=0a677a41c5f7491d949c9eb4b1098ab0&redirect_uri=https://myapp.com&response_type=code&grant_type=authorization_code&scope=Curator.Server.API Curator.Gateway.API

response_type=code - This tells the Curator that the application is initiating the authorisation code flow.
client_id - Your client application id.
redirect_uri - Tells the Curator where to send the user back to after they approve the request.
scope - One or more space-separated strings indicating which permissions the application is requesting. See the authentication section below for a complete list of API resource scopes.

2. The user will then be redirected to the Curator login screen and asked if they would like to authorise your client application.

3. If the user approves the authorisation request, Curator will redirect back to the redirect_uri specified in step 1., adding code to the query string.

https://myapp.com?code=CDD37395D64516E883615AD8862862585A5765C07E890E1022B708A43C2C04F7

4. The code can now be exchanged for an access token using the token endpoint.

The client application makes a POST request to the Curator's token endpoint with the following parameters:

grant_type=authorization_code - This tells the Curator that the application is using the authorisation code flow.
code - The application includes the authorisation code it was given in the redirect.
redirect_uri - The same redirect URI that was used when requesting the code.
client_id - The application’s client ID.
client_secret - The application’s client secret. This should be the same as the client_id.

The response will include the access_token which can then be used to make Curator API requests.

{\n    \"access_token\": \"A52CF2278F7749B914102FA39C8D6A1834C676EBA2D86AE7710A816FDA9E4D11\",\n    \"expires_in\": 3600,\n    \"token_type\": \"Bearer\",\n    \"scope\": \"Curator.Server.API Curator.Gateway.API\"\n}\n

Authentication Q&A

Can I use the simpler 'resource owner password' grant type?

\n The 'OAuth 2.0 Security Best Current Practice' disallows the password grant entirely. This\n grant type insecurely exposes the credentials of the user\n to the client. Even if the client is benign, this results in an\n increased attack surface (credentials can leak in more places than\n just the Curator Gateway) and users are trained to enter their credentials in\n places other than the Curator Gateway.\n Also, features such as multi-factor authentication, single sign-on and federation are not possible.\n

What about the 'client credentials' server-to-server grant type?

\n All Curator API requests require a users identity to be included in the access token\n so that Curator can evaluate the acting users permissions. The process for obtaining access tokens on-behalf of a user\n is described above. Although supported by Curator Gateway, grant types like 'client credentials' should not be used.\n

Pagination

The Curartor REST API uses pagination to improve performance. Pagination is enforced for operations that could return a large collection of resources.

When a request is made for paged resources, offset and limit query string parameters can be used to define the position and size of the resultset, such as:

\nhttps://[host]/CuratorGateway/api/v1/users?offset=5&limit=10\n

When you make a request to a paginated resource, the response wraps the returned array of values in a JSON object with paging metadata.

offset - The offset into the list of items.
limit - The limit/size of items requested.
size - The total number of resources.
next - The link relation for the immediate next page of results.
last - The link relation for the last page of results.
first - The link relation for the first page of results.
previous - The link relation for the immediate previous page of results.

{\n    \"href\": \"https://[host]/CuratorGateway/api/v1/users?offset=5&limit=10\",\n    \"rel\": [\n        \"collection\"\n    ],\n    \"offset\": 5,\n    \"limit\": 10,\n    \"size\": 23,\n    \"first\": {\n        \"href\": \"https://[host]/CuratorGateway/api/v1/users?offset=5&limit=10\",\n        \"rel\": [\n            \"collection\"\n        ]\n    },\n    \"previous\": {\n        \"href\": \"https://[host]/CuratorGateway/api/v1/users?offset=5&limit=10\",\n        \"rel\": [\n            \"collection\"\n        ]\n    },\n    \"next\": {\n        \"href\": \"https://[host]/CuratorGateway/api/v1/users?offset=15&limit=10\",\n        \"rel\": [\n            \"collection\"\n        ]\n    },\n    \"last\": {\n        \"href\": \"https://[host]/CuratorGateway/api/v1/users?offset=20&limit=10\",\n        \"rel\": [\n            \"collection\"\n        ]\n    },\n    \"value\": [\n    ...\n    ]\n}\n

Asynchronous Operations

Some Curator REST API operations may trigger long-running or computationally expensive tasks. In these cases, the operation will schedule an asynchronous task and return a 302 response, indicating the location of the queued task in the Location header. You can query the task by making requests to Get Task for progress updates.

When the task finishes, the response object will contain the results field. The content of the field is specific to the operation that created the task.

Note that asynchronous tasks are not guaranteed to be run in order. In other words, if you need your tasks to execute in a certain order, you should start a task only after the prerequisite task(s) have finished.

Support Portal

If further information is required, please contact us via our Support Portal or visit the Documentation Hub.

\n\n

Contact Support:\n Name: IPV\n Email: support@ipv.com

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Welcome to Curator API","slug":"welcome-to-curator-api"},{"content":"OpenAPI","slug":"openapi"},{"content":"Schema","slug":"schema"},{"content":"Version and URI","slug":"version-and-uri"},{"content":"Root Endpoint","slug":"root-endpoint"},{"content":"Hypermedia","slug":"hypermedia"},{"content":"Status Codes","slug":"status-codes"},{"content":"OAuth2 Authentication","slug":"oauth2-authentication"},{"content":"Pagination","slug":"pagination"},{"content":"Asynchronous Operations","slug":"asynchronous-operations"},{"content":"Support Portal","slug":"support-portal"}],"owner":"2965282","collectionId":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","publishedId":"TVKD1xGG","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"303030"},"publishDate":"2020-09-21T15:18:29.000Z"},"item":[{"name":null,"item":[{"name":"Get API details.","id":"5c7a64ba-1eb0-44b8-97e3-8e91a42e2f92","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1","urlObject":{"path":["api","v1"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[]}},"response":[{"id":"117fa04c-a05c-4b02-92f7-2b1deed04535","name":"An internal server error occurred.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"818e80e4-76d8-4355-ad38-66573ad626ad","name":"The root API response.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1\",\n \"users\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/users\"\n },\n \"userGroups\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/usergroups\"\n },\n \"assets\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets\"\n },\n \"metadataNames\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames\"\n },\n \"metadataViews\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadataviews\"\n },\n \"clients\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/clients\"\n },\n \"myself\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/myself\"\n },\n \"openIdConfiguration\": {\n \"href\": \"https://localhost:54279/.well-known/openid-configuration\"\n }\n}"},{"id":"ddeb7667-8cf6-47e8-8ea8-42c9e344ab6c","name":"The request is unauthorised.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"}],"_postman_id":"5c7a64ba-1eb0-44b8-97e3-8e91a42e2f92"}],"id":"b5332429-0822-4d07-a90c-b6f4df73dd30","_postman_id":"b5332429-0822-4d07-a90c-b6f4df73dd30","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":""}],"advancedConfig":[{"key":"tokenType","value":""}]},"isInherited":true,"source":{"_postman_id":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","id":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","name":"Curator API V1 (1.0)","type":"collection"}}},{"name":"Asset Thumbnails","item":[{"name":"Get asset thumbnail.","id":"dbc6694b-90db-4109-8576-050ce03f7352","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","description":"

Returns the asset thumbnail.\n The asset is identified by its ID. If a matching asset is found and it has a thumbnail a thumbnail image is returned.

\n","urlObject":{"path":["api","v1","assets",":assetId","thumbnail"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[{"id":"c0543bae-0a34-4bfe-a7aa-b0e6424660ba","description":{"content":"

(Required) The id of the asset to get the thumbnail for.

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"}]}},"response":[{"id":"0433bdde-f640-46a6-ab85-36b081f254cb","name":"The request is unauthorised.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","thumbnail"],"variable":[{"key":"assetId"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"2b0bf159-27b1-444d-a67f-d7a94f5fb5fe","name":"An internal server error occurred.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","thumbnail"],"variable":[{"key":"assetId"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"34025f90-3428-42a4-aa38-7a57464a5d12","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","thumbnail"],"variable":[{"key":"assetId"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"43f8e230-097e-496b-a055-e97daf613d54","name":"Returned if the asset is not found or the user does not have permission to view it or the asset does not have a thumbnail.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","thumbnail"],"variable":[{"key":"assetId"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"},{"id":"9102f6e8-a382-42bc-9ff0-4efc5b0da67c","name":"Returned if the request is successful.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/thumbnail","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","thumbnail"],"variable":[{"key":"assetId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"dbc6694b-90db-4109-8576-050ce03f7352"}],"id":"8ac8d9c4-4da1-4cf3-b8eb-f243f5b5fa9e","_postman_id":"8ac8d9c4-4da1-4cf3-b8eb-f243f5b5fa9e","description":"","auth":{"type":"oauth2","oauth2":{"basicConfig":[{"key":"accessToken","value":""}],"advancedConfig":[{"key":"tokenType","value":""}]},"isInherited":true,"source":{"_postman_id":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","id":"fe4a90dd-70f1-4a59-b0ff-50878c83d055","name":"Curator API V1 (1.0)","type":"collection"}}},{"name":"Assets","item":[{"name":"Get assets.","id":"bb00979b-5771-4a49-9646-73c2b526bd3c","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=&assetTypes=&assetTypes=&queries=&queries=&andQueries=&offset=&limit=","description":"

Gets a list of assets with basic searching.

\n","urlObject":{"path":["api","v1","assets"],"host":["https://localhost:54279/CuratorGateway"],"query":[{"description":{"content":"

An optional list of metadata names to return. If not set, all metadata is returned.

\n","type":"text/plain"},"key":"names","value":""},{"description":{"content":"

An optional list of metadata names to return. If not set, all metadata is returned.

\n","type":"text/plain"},"key":"names","value":""},{"description":{"content":"

An optional list of folder ids to restrict the search to. If not provided, searches are performed from the root folder.

\n","type":"text/plain"},"key":"folderIds","value":""},{"description":{"content":"

An optional list of folder ids to restrict the search to. If not provided, searches are performed from the root folder.

\n","type":"text/plain"},"key":"folderIds","value":""},{"description":{"content":"

A value indicating whether to perform a recursive search down the folder tree. The default value is true.

\n","type":"text/plain"},"key":"recursive","value":""},{"description":{"content":"

An optional list of asset types to return. If not set, all asset types are returned.

\n","type":"text/plain"},"key":"assetTypes","value":""},{"description":{"content":"

An optional list of asset types to return. If not set, all asset types are returned.

\n","type":"text/plain"},"key":"assetTypes","value":""},{"description":{"content":"

An optional list of text queries to filter the results by.\nThe format is [fieldname]:[searchvalue]. If a field is not specified, all fields are searched.

can be used as a wildcard character.

can be used to indicate a NOT query.\n\" can be used to form phase queries.\nExamples:

Name:\"My Asset\"
abc*
Name:-test

\n","type":"text/plain"},"key":"queries","value":""},{"description":{"content":"

An optional list of text queries to filter the results by.\nThe format is [fieldname]:[searchvalue]. If a field is not specified, all fields are searched.

can be used as a wildcard character.

can be used to indicate a NOT query.\n\" can be used to form phase queries.\nExamples:

Name:\"My Asset\"
abc*
Name:-test

\n","type":"text/plain"},"key":"queries","value":""},{"description":{"content":"

A value indicating whether to logically AND any specified queries. The default behaviour is to OR the queries.

\n","type":"text/plain"},"key":"andQueries","value":""},{"description":{"content":"

The optional offset into the list of items. Must be greater than or equal to 0.

\n","type":"text/plain"},"key":"offset","value":""},{"description":{"content":"

The number of items to return. Limit must be greater than or equal to 0 and less than 100.

\n","type":"text/plain"},"key":"limit","value":""}],"variable":[]}},"response":[{"id":"19681e29-81c3-49d4-bc1d-57ede53310b1","name":"An internal server error occurred.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=true&assetTypes=&assetTypes=&queries=&queries=&andQueries=false&offset=1&limit=50","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets"],"query":[{"key":"names","value":""},{"key":"names","value":""},{"key":"folderIds","value":""},{"key":"folderIds","value":""},{"key":"recursive","value":"true"},{"key":"assetTypes","value":""},{"key":"assetTypes","value":""},{"key":"queries","value":""},{"key":"queries","value":""},{"key":"andQueries","value":"false"},{"key":"offset","value":"1"},{"key":"limit","value":"50"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"6b5be2a3-74cd-4a63-b069-23a331c22e93","name":"Invalid request parameters.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=true&assetTypes=&assetTypes=&queries=&queries=&andQueries=false&offset=1&limit=50","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets"],"query":[{"key":"names","value":""},{"key":"names","value":""},{"key":"folderIds","value":""},{"key":"folderIds","value":""},{"key":"recursive","value":"true"},{"key":"assetTypes","value":""},{"key":"assetTypes","value":""},{"key":"queries","value":""},{"key":"queries","value":""},{"key":"andQueries","value":"false"},{"key":"offset","value":"1"},{"key":"limit","value":"50"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"parameter1\": [\n \"Parameter1 must be greater than 0.\"\n ]\n }\n ],\n \"status\": 400,\n \"title\": \"One or more validation errors occurred.\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.1\",\n \"traceId\": \"|56825d25-4bab64479d589d29.\"\n}"},{"id":"80634cae-e337-490c-a41b-809a7afd0c2a","name":"The request is unauthorised.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=true&assetTypes=&assetTypes=&queries=&queries=&andQueries=false&offset=1&limit=50","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets"],"query":[{"key":"names","value":""},{"key":"names","value":""},{"key":"folderIds","value":""},{"key":"folderIds","value":""},{"key":"recursive","value":"true"},{"key":"assetTypes","value":""},{"key":"assetTypes","value":""},{"key":"queries","value":""},{"key":"queries","value":""},{"key":"andQueries","value":"false"},{"key":"offset","value":"1"},{"key":"limit","value":"50"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"8e86dd4b-0c32-4380-b9ac-881dfb69cce3","name":"The list of assets is returned.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=true&assetTypes=&assetTypes=&queries=&queries=&andQueries=false&offset=1&limit=50","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets"],"query":[{"key":"names","value":""},{"key":"names","value":""},{"key":"folderIds","value":""},{"key":"folderIds","value":""},{"key":"recursive","value":"true"},{"key":"assetTypes","value":""},{"key":"assetTypes","value":""},{"key":"queries","value":""},{"key":"queries","value":""},{"key":"andQueries","value":"false"},{"key":"offset","value":"1"},{"key":"limit","value":"50"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a\",\n \"Id\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Id\",\n \"displayName\": \"Id\",\n \"values\": [\n \"5be52a09-e43f-4a48-b41b-5c33b95ee53a\"\n ],\n \"type\": \"Guid\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Id\"\n }\n },\n \"Name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Name\",\n \"displayName\": \"Name\",\n \"values\": [\n \"My Asset\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Name\"\n }\n },\n \"Description\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Description\",\n \"displayName\": \"Description\",\n \"values\": [\n \"My Asset Description\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Description\"\n }\n },\n \"FolderId\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/FolderId\",\n \"displayName\": \"FolderId\",\n \"values\": [\n \"00000000-0000-0000-0000-000001162429\"\n ],\n \"type\": \"Guid\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/FolderId\"\n }\n },\n \"AssetType\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/AssetType\",\n \"displayName\": \"AssetType\",\n \"values\": [\n \"Media\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/AssetType\"\n }\n },\n \"ProxyExists\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/ProxyExists\",\n \"displayName\": \"ProxyExists\",\n \"values\": [\n \"True\"\n ],\n \"type\": \"Boolean\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/ProxyExists\"\n }\n }\n }\n]"},{"id":"ef18a197-dc82-46a1-a045-01de893319b0","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets?names=&names=&folderIds=&folderIds=&recursive=true&assetTypes=&assetTypes=&queries=&queries=&andQueries=false&offset=1&limit=50","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets"],"query":[{"key":"names","value":""},{"key":"names","value":""},{"key":"folderIds","value":""},{"key":"folderIds","value":""},{"key":"recursive","value":"true"},{"key":"assetTypes","value":""},{"key":"assetTypes","value":""},{"key":"queries","value":""},{"key":"queries","value":""},{"key":"andQueries","value":"false"},{"key":"offset","value":"1"},{"key":"limit","value":"50"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"}],"_postman_id":"bb00979b-5771-4a49-9646-73c2b526bd3c"},{"name":"Get asset.","id":"53d4d151-bdf7-4046-a1f9-2cee2aba3c07","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","description":"

Returns the details for an asset.\n The asset is identified by its ID. If a matching asset is found its details are returned.

\n","urlObject":{"path":["api","v1","assets",":assetId"],"host":["https://localhost:54279/CuratorGateway"],"query":[{"description":{"content":"

An optional list list of metadata names to return. If not set, all metadata is returned.

\n","type":"text/plain"},"key":"names","value":""},{"description":{"content":"

An optional list list of metadata names to return. If not set, all metadata is returned.

\n","type":"text/plain"},"key":"names","value":""}],"variable":[{"id":"6e49a6d5-5994-4f9d-be8c-f96fb9af575e","description":{"content":"

(Required) The id of the asset to get

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"}]}},"response":[{"id":"4abc3ac9-ca95-4157-ba9f-d97ac455902b","name":"The request is unauthorised.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"query":[{"key":"names","value":""},{"key":"names","value":""}],"variable":[{"key":"assetId"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"7d72a4b8-919f-47ad-895d-6480aa362c5a","name":"Returned if the asset is not found or the user does not have permission to view it.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"query":[{"key":"names","value":""},{"key":"names","value":""}],"variable":[{"key":"assetId"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"},{"id":"a3a3f3dd-586a-4998-be2f-73bd2ffd47bc","name":"An internal server error occurred.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"query":[{"key":"names","value":""},{"key":"names","value":""}],"variable":[{"key":"assetId"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"b5b63ef1-96e3-40c2-ab6d-ad712cb7ea8d","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"query":[{"key":"names","value":""},{"key":"names","value":""}],"variable":[{"key":"assetId"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"f97bbeb4-2acd-4c20-baf5-8f41391c0ba5","name":"Returned if the request is successful.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId?names=&names=","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"query":[{"key":"names","value":""},{"key":"names","value":""}],"variable":[{"key":"assetId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a\",\n \"Id\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Id\",\n \"displayName\": \"Id\",\n \"values\": [\n \"5be52a09-e43f-4a48-b41b-5c33b95ee53a\"\n ],\n \"type\": \"Guid\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Id\"\n }\n },\n \"Name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Name\",\n \"displayName\": \"Name\",\n \"values\": [\n \"My Asset\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Name\"\n }\n },\n \"Description\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/Description\",\n \"displayName\": \"Description\",\n \"values\": [\n \"My Asset Description\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/Description\"\n }\n },\n \"FolderId\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/FolderId\",\n \"displayName\": \"FolderId\",\n \"values\": [\n \"00000000-0000-0000-0000-000001162429\"\n ],\n \"type\": \"Guid\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/FolderId\"\n }\n },\n \"AssetType\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/AssetType\",\n \"displayName\": \"AssetType\",\n \"values\": [\n \"Media\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/AssetType\"\n }\n },\n \"ProxyExists\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/ProxyExists\",\n \"displayName\": \"ProxyExists\",\n \"values\": [\n \"True\"\n ],\n \"type\": \"Boolean\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/ProxyExists\"\n }\n }\n}"}],"_postman_id":"53d4d151-bdf7-4046-a1f9-2cee2aba3c07"},{"name":"Does asset exist?","id":"6d137988-5ac5-4e28-90ac-049ae89d6fe9","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"HEAD","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","description":"

Used to check if an asset exists with the specified id.

\n","urlObject":{"path":["api","v1","assets",":assetId"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[{"id":"745f6760-f0e9-43bd-b26f-4ee72f28e499","description":{"content":"

(Required) The asset id to check exists.

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"}]}},"response":[{"id":"31d72a80-61e0-42b3-baa2-c8cca1760d49","name":"An internal server error occurred.","originalRequest":{"method":"HEAD","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"variable":[{"key":"assetId"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"4a7e5f66-7b7a-48c4-989f-e071d79bdea4","name":"The asset does not exist.","originalRequest":{"method":"HEAD","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"variable":[{"key":"assetId"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"},{"id":"5835f396-c955-434d-b581-8b320eb08922","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"HEAD","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"variable":[{"key":"assetId"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"a845a524-0afb-4c5b-ac90-7e9b03eea365","name":"The asset does exist.","originalRequest":{"method":"HEAD","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"variable":[{"key":"assetId"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"dfecc7a7-6a3f-400d-8ff2-98f77a5fecd8","name":"The request is unauthorised.","originalRequest":{"method":"HEAD","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId"],"variable":[{"key":"assetId"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"}],"_postman_id":"6d137988-5ac5-4e28-90ac-049ae89d6fe9"},{"name":"Get asset metadata.","id":"33c8e14d-47dc-4d43-8848-8e94cb4bbab0","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"GET","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","description":"

Returns an assets metadata.

\n","urlObject":{"path":["api","v1","assets",":assetId","metadata",":name"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[{"id":"6622fd8e-c818-4a57-9e7a-56978bc882d0","description":{"content":"

(Required) The id of the asset to get metadata for.

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"},{"id":"acd9a0c5-021f-4c65-9943-9c81e14e11db","description":{"content":"

(Required) The name of metadata to return.

\n","type":"text/plain"},"type":"string","value":"","key":"name"}]}},"response":[{"id":"37ca4f61-1329-49bf-b36b-bad340930ec8","name":"The asset metadata.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/assets/5be52a09-e43f-4a48-b41b-5c33b95ee53a/metadata/MyMetadataName\",\n \"displayName\": \"My Metadata Name\",\n \"values\": [\n \"My Metadata Value\"\n ],\n \"type\": \"Text\",\n \"name\": {\n \"href\": \"https://localhost:54279/CuratorGateway/api/v1/metadatanames/MyMetadataName\"\n }\n}"},{"id":"5f488a09-96b8-428e-90c9-c4c4269462af","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"6dbfaa7a-cf30-43af-84e9-5d286005392f","name":"The request is unauthorised.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"b1024f9c-3fd9-4f41-800d-21af653791ee","name":"An internal server error occurred.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"dc8e228f-f500-4863-977c-aee957d0e85f","name":"Returned if the asset or property is not found or the user does not have permission to see the asset.","originalRequest":{"method":"GET","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"}],"_postman_id":"33c8e14d-47dc-4d43-8848-8e94cb4bbab0"},{"name":"Set asset metadata.","id":"eb035987-af96-4079-8edc-7c913c7480b6","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"PUT","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","description":"

Sets the value of an asset's metadata. If the metadata name doesn't exist it is created. If the asset metadata does not exist it is added against the asset. If it exists the value is updated.

\n","urlObject":{"path":["api","v1","assets",":assetId","metadata",":name"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[{"id":"25db27e3-4951-45fd-ba2f-25d34489fec2","description":{"content":"

(Required) The id of the asset to get metadata for.

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"},{"id":"6984151e-215a-4d93-9e54-bfec15d3c820","description":{"content":"

(Required) The name of metadata to set.

\n","type":"text/plain"},"type":"string","value":"","key":"name"}]}},"response":[{"id":"08210a32-0866-4f4a-9c5f-c53ab7834ac5","name":"An internal server error occurred.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"1a1a5e13-7168-4cdd-92f5-d400f4e6d4c4","name":"Returned if the asset metadata or metadata name is created.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Created","code":201,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"320a6be8-28ce-48ab-94ed-7d9656cbc99f","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"6d367ccc-46e8-4f20-b7c6-b736a7cefbf8","name":"Returned if the asset is not found or the user does not have permission to edit the asset.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"},{"id":"74136360-3745-44d7-b166-cb1a5fca09f0","name":"The request is unauthorised.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"dd8f664f-2f3e-4e42-813a-d3a3939cc7b4","name":"Returned if the asset metadata is updated.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"ff0de855-60d1-4996-b313-6a4e6b8729f7","name":"Invalid request parameters.","originalRequest":{"method":"PUT","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"body":{"mode":"raw","raw":"[\n \"\",\n \"\"\n]"},"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"errors\": [\n {\n \"parameter1\": [\n \"Parameter1 must be greater than 0.\"\n ]\n }\n ],\n \"status\": 400,\n \"title\": \"One or more validation errors occurred.\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.1\",\n \"traceId\": \"|56825d25-4bab64479d589d29.\"\n}"}],"_postman_id":"eb035987-af96-4079-8edc-7c913c7480b6"},{"name":"Delete asset metadata.","id":"54bfc0f7-1f85-4f62-ab23-4c4ea90bc74c","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"DELETE","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"}],"url":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","description":"

Deletes an assets's metadata.

\n","urlObject":{"path":["api","v1","assets",":assetId","metadata",":name"],"host":["https://localhost:54279/CuratorGateway"],"query":[],"variable":[{"id":"30404211-213f-4380-ad93-f32eea8437b5","description":{"content":"

(Required) The id of the asset to delete.

\n","type":"text/plain"},"type":"string","value":"","key":"assetId"},{"id":"10632829-e1f4-4525-883e-0ac709a52345","description":{"content":"

(Required) The name of metadata to delete.

\n","type":"text/plain"},"type":"string","value":"","key":"name"}]}},"response":[{"id":"0845b310-3a34-483a-82af-055e2e27d7f4","name":"The request is forbidden. Required scopes: Curator.Server.API","originalRequest":{"method":"DELETE","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 403,\n \"title\": \"Forbidden\",\n \"type\": \"https://httpstatuses.com/403\",\n \"traceId\": \"|5fc214de-461261a6cea7b598.\"\n}"},{"id":"1d0497ac-35d9-4695-b892-bf032c637b8d","name":"An internal server error occurred.","originalRequest":{"method":"DELETE","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"detail\": \"An error occured when communicating with service.\",\n \"status\": 500,\n \"title\": \"Internal Server Error\",\n \"type\": \"https://httpstatuses.com/500\",\n \"traceId\": \"|3a3bc0fe-4b2e003bbe4637e6.\"\n}"},{"id":"b4938204-fafd-490e-979e-0a1f44be4590","name":"The request is unauthorised.","originalRequest":{"method":"DELETE","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 401,\n \"title\": \"Unauthorized\",\n \"type\": \"https://httpstatuses.com/401\",\n \"traceId\": \"|4dc214de-461261a6cea7b558.\"\n}"},{"id":"ceced5d5-9c79-473d-9b3c-dcb5aeb5e568","name":"Returned if the asset or property is not found or the user does not have permission to see the asset.","originalRequest":{"method":"DELETE","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 404,\n \"title\": \"Not Found\",\n \"type\": \"https://tools.ietf.org/html/rfc7231#section-6.5.4\",\n \"traceId\": \"|6e56eb80-405baf41b5edd0f1.\"\n}"},{"id":"ede5a223-1ceb-4c5f-bb1e-1292873fddde","name":"The asset metadata was deleted successfully.","originalRequest":{"method":"DELETE","header":[{"description":"(Required) The access token.","key":"Authorization","value":"Bearer [access token]"}],"url":{"raw":"https://localhost:54279/CuratorGateway/api/v1/assets/:assetId/metadata/:name","host":["https://localhost:54279/CuratorGateway"],"path":["api","v1","assets",":assetId","metadata",":name"],"variable":[{"key":"assetId"},{"key":"name"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"54bfc0f7-1f85-4f62-ab23-4c4ea90bc74c"},{"name":"Create asset from file.","id":"4b72b055-2414-4cdd-857f-4cfb0f537d06","request":{"auth":{"type":"oauth2","oauth2":{"basicConfig":[]},"isInherited":false},"method":"POST","header":[{"description":"

(Required) The access token.

\n","key":"Authorization","value":"Bearer [access token]"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"filePath\": \"\",\n \"metadata\": \"