​
Creating and permissioning a new mock API

Follow these steps to create a mock API then grant a single user permission to use it:
1

Create a new mock API

Start by calling the create new mock API endpoint, specifying the name, type and hostname of the API.The type can be left blank for an unstructured, or it can be grpc or openapi.The hostname is the friendly unqualified domain name used in the base URL. It is optional, and if omitted the generated ID for the mock API will be used in the domain name.Save the mock API’s ID from the response.
2

Get the ACL candidates

Follow the mockApi.links.acl link in the response gained in the previous step, which will return ACL candidates.From within the returned data, find the user to whom you wish to grant access to the mock API and follow the link to the user resource. Save the user’s ID.
3

Grant access to the user

Call update an entity’s ACL, setting the following parameters:entityCollection = mock-apisentityId = <the mock API ID>subjectType = usersubjectEntityId = <the user’s ID>The body must contain the role to be granted e.g. mock_api_editor.
Similar steps can be taken when adding a team rather than a single user to the permissions.