{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Until the new spaces UI concept is available people need to create scopes via the API. This is a guide that leads you through the calls needed for it.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Token of a user / service-user which has admin role assigned → ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The base URL of your application → ","type":"text"}]}]}]},{"type":"panel","attrs":{"panelIconId":"2139","panelIcon":":information_source:","panelIconText":"ℹ️","panelColor":"#E6FCFF","panelType":"custom"},"content":[{"type":"paragraph","content":[{"text":"To get the token and the URL check this: ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://unique-ch.atlassian.net/wiki/spaces/PUB/pages/577929672"}},{"text":" ","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating a scope","type":"text"}]},{"type":"paragraph","content":[{"text":"First, you need to create the scope itself. This can be done with this cURL. Just replace the following placeholders: / / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"84be258f-8f27-4227-8a19-c0946290bb25"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"96f79358-19c5-4d88-81dc-38bbe750f2af"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"mutation CreateScope($name: String!) {\\n createScope(name: $name) {\\n id\\n name\\n }\\n}\",\"variables\":{\"name\":\"\"}}'","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"This should respond with the following successful response with your replaced and a new unique :","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"createScope\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"The scope is now created but no one has access to it. For this, you need to create a scopeAccess object","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating scope access","type":"text"}]},{"type":"paragraph","content":[{"text":"The Scope Access object defines who has access to a scope and which type of access it is. A scope can have multiple scope access objects. The scope access contains:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the (","type":"text"},{"text":"GROUP","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"USER","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the which should have access to the scope (userId or groupId)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the (","type":"text"},{"text":"READ","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"WRITE","type":"text","marks":[{"type":"code"}]},{"text":") ","type":"text"},{"type":"hardBreak"},{"text":"READ","type":"text","marks":[{"type":"code"}]},{"text":" can only query data of this scope, ","type":"text"},{"text":"WRITE","type":"text","marks":[{"type":"code"}]},{"text":" can only insert new data, update data, and delete data.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The cURL for creating this entity is the following. Replace again the values needed for the CURL: / / / / / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"5ad800d9-074b-43d3-afb4-a5c58b734535"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"e81f9181-a434-4671-b3a9-51aba6bd1334"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"mutation CreateScopeAccess($accessType: String!, $entityId: String!, $entityType: String!, $scopeId: String!, $skipUserCheck: Boolean) {\\n createScopeAccess(accessType: $accessType, entityId: $entityId, entityType: $entityType, scopeId: $scopeId, skipUserCheck: $skipUserCheck) {\\n scopeId\\n type\\n entityType\\n entityId\\n }\\n}\",\"variables\":{\"accessType\":\"\",\"entityId\":\"\",\"entityType\":\"\",\"scopeId\":\"\"}}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The successful cURL should give you the following response:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"createScopeAccess\": {\n \"scopeId\": \"\",\n \"type\": \"\",\n \"entityType\": \"\",\n \"entityId\": \"\"\n }\n }\n}","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"AccessType WRITE does not implicit give you READ allowance. If you want to give to an entity (User or Group) READ and WRITE access you need to create two scope access objects -> one with READ and one with WRITE for the same entity.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Removing scope access","type":"text"}]},{"type":"paragraph","content":[{"text":"If a scope access has been created wrongly or anything you want to change anything with previously created accesses, you can use the following cUrl.","type":"text"}]},{"type":"paragraph","content":[{"text":"Just replace the values analog to the creating query.","type":"text"},{"type":"hardBreak"},{"text":" / / / / / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"1d640577-c72c-4cb3-b4bd-98cfa3103e40"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"072639bd-fd6c-4b4e-9d7c-69f8533b3889"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"mutation DeleteScopeAccess($accessType: String!, $entityId: String!, $entityType: String!, $scopeId: String!) {\\n deleteScopeAccess(accessType: $accessType, entityId: $entityId, entityType: $entityType, scopeId: $scopeId) {\\n scopeId\\n }\\n}\",\"variables\":{\"accessType\":\"\",\"entityId\":\"\",\"entityType\":\"\",\"scopeId\":\"\"}}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The successful response should look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"deleteScopeAccess\": {\n \"scopeId\": \"\"\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Query all Scopes","type":"text"}]},{"type":"paragraph","content":[{"text":"The following call returns all scopes. Replace the values needed for the CURL: / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"71ea341e-e287-451b-84ae-2034d43637cb"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"893c0818-61ae-4299-aea2-7d1410ec8602"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"query Scopes {\\n scopes {\\n id\\n name\\n createdAt\\n updatedAt\\n }\\n}\",\"variables\":{}}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The successful cURL should give you the following response:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"scopes\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"createdAt\": \"\",\n \"updatedAt\": \"\"\n }\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Query Scopes with its access configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The following call returns the scopes. Replace the values needed for the CURL: / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"484be51f-4629-4ab5-8cf2-7aae3f12013a"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"212be058-edda-48c0-a2a2-794bf7803f01"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"query Scopes($where: ScopeWhereInput) {\\n scopes(where: $where) {\\n id\\n name\\n createdAt\\n scopeAccess {\\n type\\n entityId\\n entityType\\n }\\n }\\n}\",\"variables\":{}}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The successful cURL should give you the following response:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"scopes\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"createdAt\": \"\",\n \"scopeAccess\": [\n {\n \"type\": \"READ\",\n \"entityId\": \"\",\n \"entityType\": \"GROUP\"\n },\n {\n \"type\": \"WRITE\",\n \"entityId\": \"\",\n \"entityType\": \"USER\"\n },...\n ]\n }\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Query Scopes assigned to a User","type":"text"}]},{"type":"paragraph","content":[{"text":"The following call returns all scopes for the user the access token used belongs to. Replace the values needed for the CURL: / ","type":"text"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"APIs & Integrations"},"name":{"value":"internal-api-warning"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"e4576650-9fab-4d18-b849-b66d62b2481a"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"8d511340-a606-4155-8aee-ed83e1dfd9db"}}]},{"type":"codeBlock","content":[{"text":"curl --location 'https://gateway./scope-management/graphql' \\\n--header 'Content-Type: application/json' \\\n--header 'Authorization: Bearer ' \\\n--data '{\"query\":\"query OwnScopes {\\n ownScopes {\\n id\\n name\\n createdAt\\n updatedAt\\n }\\n}\",\"variables\":{}}'","type":"text"}]},{"type":"paragraph","content":[{"text":"The successful cURL should give you the following response:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"data\": {\n \"ownScopes\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"createdAt\": \"2024-05-15T07:06:59.227Z\",\n \"updatedAt\": \"2024-05-15T07:06:59.227Z\"\n }\n ]\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Delete Scopes","type":"text"}]},{"type":"paragraph","content":[{"text":"Scopes can be delted as follows, they wont be deletable if they still contain Content. So content must be moved out of a scope or deleted.","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl --request POST \\\n --header 'content-type: application/json' \\\n --header 'Authorization: Bearer ' \\\n --url https://gateway./scope-management/graphql \\\n --data '{\"query\":\"mutation DeleteGroup($scopeId: String!) {\\n deleteScope(scopeId: $scopeId) {\\n id\\n }\\n}\",\"variables\":{\"scopeId\":\"scope...\"}}'","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Conclusion","type":"text"}]},{"type":"paragraph","content":[{"text":"Now the entities that have access to this scope and also to the knowledge-base app should be able to see this scope in the UI. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"People with WRITE access can select this scope to upload data. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"People with READ access can see the data in the table below. ","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"rule"},{"type":"table","attrs":{"layout":"default","width":633.0,"localId":"9bb6a5c3-0d07-4a37-a162-cc4510dd04df"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[110.0]},"content":[{"type":"paragraph","content":[{"text":"Author","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[523.0]},"content":[{"type":"paragraph","content":[{"type":"mention","attrs":{"id":"63eb588dc5061c632c0caec1","text":"@Adrian Gugger"}},{"text":" ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported