diff --git a/content/notifications/explanation/_index.md b/content/notifications/explanation/_index.md
new file mode 100644
index 00000000000..f56d97530f0
--- /dev/null
+++ b/content/notifications/explanation/_index.md
@@ -0,0 +1,7 @@
+---
+title: Explanation
+description: Underlying concepts or principle explained
+weight: 60
+---
+
+{{}}
\ No newline at end of file
diff --git a/content/notifications/explanation/address-lookup/_index.md b/content/notifications/explanation/address-lookup/_index.md
new file mode 100644
index 00000000000..8ee24900880
--- /dev/null
+++ b/content/notifications/explanation/address-lookup/_index.md
@@ -0,0 +1,139 @@
+---
+title: Address Lookup
+description: "The principles of address lookup explained. Address lookup is one of the benefits of using Altinn Notifications.
+However, understanding how it works and which registries are used in various situations is not easy.
+in this article, we dive deep into the principles of address lookup, explaining the process for different types of notifications."
+weight: 20
+---
+
+
+In relation to address lookup, we categorize notifications into five distinct types:
+1. **Notification to provided email or mobile number**
+2. **Stand alone notification to national identity number**
+3. **Stand alone notification to organization number**
+4. **Notification associated with a resource to national identity number**
+5. **Notification associated with a resource to organization number**
+
+## 1. Notification to provided email or mobile number
+For notifications sent to a provided email address or mobile number,
+the service owner must identify and provide the recipient's contact details.
+Notifications will be sent to the specified contact points,
+provided they are successfully validated at the time the notification order is placed.
+
+### Data Integrity
+The service owner is responsible for ensuring the integrity of the data provided to Altinn Notifications.
+
+## 2. Stand alone notification to national identity number
+When a notification is sent to a national identity number without resource association,
+it is called a stand alone notification.
+Altinn Notifications utilizes the **Contact and Reservation Register (KRR)** to identify the recipient's contact details.
+If contact points exist, this results in obtaining an email address and/or mobile number,
+depending on the notification channel.
+However, if the national identity number provided is incorrect,
+the notification will not be sent and will instead fail with an error status, indicating "recipient not identified"
+or "missing contact details".
+
+### Process Details
+
+
+{{% notice info %}}
+**A note on reservation from electronic communication**
+
+End users can reserve themselves against electronic communication in KRR,
+but a service owner can choose to ignore this flag if the nature of the notification permits them to.
+In the case a user has reserved themselves and the service owner has not overridden this,
+no contact details will ever be exposed to the end user.
+Rather, the lookup result will specify the national identity number of the reserved individual.
+{{% /notice %}}
+
+### Populating KRR
+End users can manage their contact details and communication preferences,
+including reservations against online communication,
+by accessing [their profile on the KRR website](https://minprofil.kontaktregisteret.no/).
+
+### Data Integrity
+
+Basic validation during registration in KRR ensures that users provide a valid mobile number and email address.
+In addition to this, the user is prompted during login in ID-porten every 90 days to confirm or update their contact details.
+Contact details that have not been confirmed or updated in the last 18 months are not provided through the lookup service.
+
+## 3. Stand alone notification to organization number
+
+When notifications sent to an organization number without resource association
+it is called a stand alone notification.
+Altinn uses the registry of **Notification addresses to apply in public administration** to identify the
+contact details of the recipient.
+This can include a list of email addresses and/or mobile numbers, depending on the notification channel.
+It is important to note that Altinn does not validate the accuracy of the details from this registry.
+If the data is inaccurate or incomplete, the notification will not be sent and will instead fail with a
+status indicating "invalid contact point".
+
+### Process Details
+
+
+### Populating Notification addresses to apply in public administration
+Organizations can manage their official contact details for public administration by logging into
+their organization’s profile in the [Altinn portal](https://www.altinn.no).
+It is possible to register multiple email addresses and mobile numbers for an organization.
+
+
+
+### Data Integrity
+The affiliates of the organization must ensure the contact information is up-to-date to receive notifications appropriately.
+Basic validation in the Altinn portal ensures that users provide a valid mobile number and email address,
+and the contact points bust be accepted by Brønnøysundregistrene before they are made available through the lookup service.
+
+Affiliates of the organization are prompted every 90 days to confirm or update the contact information
+through the Altinn Portal.
+
+## 4. Notification associated with a resource to national identity number
+In this scenario, Altinn does not look up additional recipients if the recipient is a person identified by
+national identity number.
+Therefore, only their KRR contact details are relevant to retrieve.
+
+Please reference [Stand alone notification to national identity number](#2-stand-alone-notification-to-national-identity-number)
+for relevant details.
+
+## 5. Notification associated with a resource to organization number
+In this scenario, Altinn uses both the registry of **Notification addresses to apply in public administration**
+and end users' **personal contact information for enterprises** to determine the addresses to notify.
+However, before notifications are sent, the list of recipients is filtered based on the authorization policy of the resource.
+Only individuals authorized to access the resource will receive a notification.
+
+
+Altinn checks authorization when the order is placed and again just before the notification is sent.
+Thus, one can trust that all recipients are authorized when the notification is actually sent,
+regardless of how much time has passed since the order was placed.
+
+### Process details
+
+
+### Populating data sources
+__Notification addresses to apply in public administration__
+
+Please revisit [the previous section covering populating Notification addresses to apply in public administration](#populating-notification-addresses-to-apply-in-public-administration)
+
+__Personal contact information for enterprises__
+
+Users affiliated with an organization can register their personal contact details through the organization’s profile on the Altinn portal.
+One email address and one mobile number can be registered per user.
+
+
+
+In addition to specifying contact information the end user can opt to only receive notifications
+regarding specific services and/or resources.
+
+
+
+### Data Integrity
+
+__Notification addresses to apply in public administration__
+
+Please revisit [the previous section covering data integrity of notification addresses to apply in public administration](#data-integrity-2)
+
+
+__Personal contact information for enterprises__
+
+End user is free to input the contact details they wish and the input is subject to basic validation.
+Affiliates of the organization are prompted every 90 days to confirm or update the contact information
+through the Altinn Portal.
\ No newline at end of file
diff --git a/content/notifications/explanation/address-lookup/official-address-panel-portal.PNG b/content/notifications/explanation/address-lookup/official-address-panel-portal.PNG
new file mode 100644
index 00000000000..f71c2ac881e
Binary files /dev/null and b/content/notifications/explanation/address-lookup/official-address-panel-portal.PNG differ
diff --git a/content/notifications/explanation/address-lookup/org-no-resource-flow.drawio.svg b/content/notifications/explanation/address-lookup/org-no-resource-flow.drawio.svg
new file mode 100644
index 00000000000..310e8b1ed0a
--- /dev/null
+++ b/content/notifications/explanation/address-lookup/org-no-resource-flow.drawio.svg
@@ -0,0 +1,281 @@
+
\ No newline at end of file
diff --git a/content/notifications/explanation/address-lookup/org-with-resource-flow.drawio.svg b/content/notifications/explanation/address-lookup/org-with-resource-flow.drawio.svg
new file mode 100644
index 00000000000..ba83a2297b5
--- /dev/null
+++ b/content/notifications/explanation/address-lookup/org-with-resource-flow.drawio.svg
@@ -0,0 +1,362 @@
+
\ No newline at end of file
diff --git a/content/notifications/explanation/address-lookup/person-no-resource-flow.drawio.svg b/content/notifications/explanation/address-lookup/person-no-resource-flow.drawio.svg
new file mode 100644
index 00000000000..3d9187ee319
--- /dev/null
+++ b/content/notifications/explanation/address-lookup/person-no-resource-flow.drawio.svg
@@ -0,0 +1,281 @@
+
\ No newline at end of file
diff --git a/content/notifications/explanation/address-lookup/user-registered-org-address-panel-portal.PNG b/content/notifications/explanation/address-lookup/user-registered-org-address-panel-portal.PNG
new file mode 100644
index 00000000000..d0fa8677e67
Binary files /dev/null and b/content/notifications/explanation/address-lookup/user-registered-org-address-panel-portal.PNG differ
diff --git a/content/notifications/explanation/address-lookup/user-registered-service-spec.PNG b/content/notifications/explanation/address-lookup/user-registered-service-spec.PNG
new file mode 100644
index 00000000000..d70f76ebac8
Binary files /dev/null and b/content/notifications/explanation/address-lookup/user-registered-service-spec.PNG differ
diff --git a/content/notifications/news/_index.en.md b/content/notifications/news/_index.en.md
new file mode 100644
index 00000000000..5c30a1ce40c
--- /dev/null
+++ b/content/notifications/news/_index.en.md
@@ -0,0 +1,12 @@
+---
+title: Whats's new
+description: What's new in Altinn Notifications
+weight: 70
+---
+
+## Upcoming
+{{% insert "content/notifications/news/upcoming/_index.en.md" %}}
+
+
+## Recently delivered
+{{% insert "content/notifications/news/delivered/_index.en.md" %}}
\ No newline at end of file
diff --git a/content/notifications/news/delivered/_index.en.md b/content/notifications/news/delivered/_index.en.md
new file mode 100644
index 00000000000..dc045853a61
--- /dev/null
+++ b/content/notifications/news/delivered/_index.en.md
@@ -0,0 +1,35 @@
+---
+title: Delivered
+description: Recently delivered functionality
+weight: 2
+hidden: true
+---
+
+
+ {{}}
+ {{}}
+ {{}}
+ {{}}
+
+
+
\ No newline at end of file
diff --git a/content/notifications/news/upcoming/_index.en.md b/content/notifications/news/upcoming/_index.en.md
new file mode 100644
index 00000000000..71e3d478df2
--- /dev/null
+++ b/content/notifications/news/upcoming/_index.en.md
@@ -0,0 +1,15 @@
+---
+title: Upcoming
+description: Upcoming functionality
+weight: 1
+hidden: true
+---
+
+
+ {{}}
+
\ No newline at end of file
diff --git a/content/notifications/reference/_index.en.md b/content/notifications/reference/_index.en.md
new file mode 100644
index 00000000000..da07e77132d
--- /dev/null
+++ b/content/notifications/reference/_index.en.md
@@ -0,0 +1,7 @@
+---
+title: Reference
+description: Reference documentation for Altinn Studio
+weight: 50
+---
+
+{{}}
\ No newline at end of file
diff --git a/content/notifications/architecture/_index.en.md b/content/notifications/reference/architecture/_index.en.md
similarity index 100%
rename from content/notifications/architecture/_index.en.md
rename to content/notifications/reference/architecture/_index.en.md
diff --git a/content/notifications/architecture/email/_index.en.md b/content/notifications/reference/architecture/email/_index.en.md
similarity index 100%
rename from content/notifications/architecture/email/_index.en.md
rename to content/notifications/reference/architecture/email/_index.en.md
diff --git a/content/notifications/architecture/email/openAPI/_index.en.md b/content/notifications/reference/architecture/email/openAPI/_index.en.md
similarity index 100%
rename from content/notifications/architecture/email/openAPI/_index.en.md
rename to content/notifications/reference/architecture/email/openAPI/_index.en.md
diff --git a/content/notifications/architecture/flowchart-email-notifications-process.drawio.svg b/content/notifications/reference/architecture/flowchart-email-notifications-process.drawio.svg
similarity index 100%
rename from content/notifications/architecture/flowchart-email-notifications-process.drawio.svg
rename to content/notifications/reference/architecture/flowchart-email-notifications-process.drawio.svg
diff --git a/content/notifications/architecture/flowchart-order-process.drawio.svg b/content/notifications/reference/architecture/flowchart-order-process.drawio.svg
similarity index 100%
rename from content/notifications/architecture/flowchart-order-process.drawio.svg
rename to content/notifications/reference/architecture/flowchart-order-process.drawio.svg
diff --git a/content/notifications/architecture/flowchart-sms-notifications-process.drawio.svg b/content/notifications/reference/architecture/flowchart-sms-notifications-process.drawio.svg
similarity index 100%
rename from content/notifications/architecture/flowchart-sms-notifications-process.drawio.svg
rename to content/notifications/reference/architecture/flowchart-sms-notifications-process.drawio.svg
diff --git a/content/notifications/architecture/kafka/_index.en.md b/content/notifications/reference/architecture/kafka/_index.en.md
similarity index 100%
rename from content/notifications/architecture/kafka/_index.en.md
rename to content/notifications/reference/architecture/kafka/_index.en.md
diff --git a/content/notifications/architecture/notifications/_index.en.md b/content/notifications/reference/architecture/notifications/_index.en.md
similarity index 98%
rename from content/notifications/architecture/notifications/_index.en.md
rename to content/notifications/reference/architecture/notifications/_index.en.md
index 4e1c3b9f6f1..981789fbea7 100644
--- a/content/notifications/architecture/notifications/_index.en.md
+++ b/content/notifications/reference/architecture/notifications/_index.en.md
@@ -149,10 +149,10 @@ Notifications microservice takes use of a range of libraries to support the prov
| Library | Purpose | Resources |
| ----------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
-| AccessToken | Used to validate tokens in requests | [Repository](https://github.com/altinn/altinn-accesstoken), [Documentation](../../../authentication/architecture/accesstoken/) |
+| AccessToken | Used to validate tokens in requests | [Repository](https://github.com/altinn/altinn-accesstoken), [Documentation](../../../../authentication/architecture/accesstoken/) |
| Confluent.Kafka | Integrate with kafka broker | [Repository](https://github.com/confluentinc/confluent-kafka-dotnet), [Documentation](https://developer.confluent.io/get-started/dotnet/) |
| FluentValidation | Used to validate content of API request | [Repository](https://github.com/FluentValidation/FluentValidation), [Documentation](https://docs.fluentvalidation.net/en/latest/) |
-| JWTCookieAuthentication | Used to validate Altinn token (JWT) | [Repository](https://github.com/Altinn/altinn-authentication), [Documentation](../../../authentication/architecture/jwtcookie/) |
+| JWTCookieAuthentication | Used to validate Altinn token (JWT) | [Repository](https://github.com/Altinn/altinn-authentication), [Documentation](../../../../authentication/architecture/jwtcookie/) |
| libphonenumber-csharp | Used to validate mobile numbers | [Repository](https://github.com/caseykramer/libphonenumber-csharp), [Documentation](https://github.com/caseykramer/libphonenumber-csharp) |
| Npgsql | Used to access the database server | [Repository]( https://github.com/rdagumampan/yuniql ), [Documentation](https://www.npgsql.org/) |
| Yuniql | DB migration | [Repository](https://github.com/rdagumampan/yuniql), [Documentation](https://yuniql.io/) |
diff --git a/content/notifications/architecture/notifications/db-schema.png b/content/notifications/reference/architecture/notifications/db-schema.png
similarity index 100%
rename from content/notifications/architecture/notifications/db-schema.png
rename to content/notifications/reference/architecture/notifications/db-schema.png
diff --git a/content/notifications/architecture/sms/_index.en.md b/content/notifications/reference/architecture/sms/_index.en.md
similarity index 100%
rename from content/notifications/architecture/sms/_index.en.md
rename to content/notifications/reference/architecture/sms/_index.en.md
diff --git a/content/notifications/architecture/sms/openAPI/_index.en.md b/content/notifications/reference/architecture/sms/openAPI/_index.en.md
similarity index 100%
rename from content/notifications/architecture/sms/openAPI/_index.en.md
rename to content/notifications/reference/architecture/sms/openAPI/_index.en.md
diff --git a/content/notifications/architecture/solution.drawio.svg b/content/notifications/reference/architecture/solution.drawio.svg
similarity index 100%
rename from content/notifications/architecture/solution.drawio.svg
rename to content/notifications/reference/architecture/solution.drawio.svg
diff --git a/content/notifications/send-notifications/_index.en.md b/content/notifications/send-notifications/_index.en.md
index 6983446bb88..e105f54c15e 100644
--- a/content/notifications/send-notifications/_index.en.md
+++ b/content/notifications/send-notifications/_index.en.md
@@ -20,11 +20,11 @@ This functionality can be expected in the first half of '24.
## Recipient lookup
-Sending notifications to a national identity number or organization number is possible.
+Sending notifications to a national identity number or organization number is supported.
A lookup of the contact details and reservation status of the recipient will be done both at the time
of ordering a request and at the requested send time.
-The entity ordering the notification is responsible to checking whether the notification
+The entity ordering the notification is responsible for checking whether the notification
will be sent or not, as recipient lookup results are shared in the response of the order request
as well as detailed in the notification after requested send time.
diff --git a/content/notifications/send-notifications/developer-guides/get-email-notifications/_index.en.md b/content/notifications/send-notifications/developer-guides/get-email-notifications/_index.en.md
index 79759b3a48d..77d17cca169 100644
--- a/content/notifications/send-notifications/developer-guides/get-email-notifications/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/get-email-notifications/_index.en.md
@@ -11,7 +11,7 @@ toc: true
GET /order/{id}/notifications/email
-{id} represents the id of the notification order to retrieve notifications for.
+{id} represents the ID of the notification order to retrieve notifications for.
## Authentication
@@ -25,7 +25,7 @@ See [Authentication and Authorization](../../../api/#authentication--authorizati
### Response codes
- 200 OK: The email notifications were successfully retrieved
-- 404 Not Found: No order matching the provided id were found
+- 404 Not Found: No order matching the provided ID were found
Refer to problem details in response body for further information.
- 401 Unauthorized: Indicates a missing, invalid or expired authorization header.
@@ -45,7 +45,7 @@ and serialized as a JSON string.
#### orderId
Type: _Guid_
-The id of the notification order the listed notifications are related to
+The ID of the notification order the listed notifications are related to
#### sendersReference
Type: _string_
@@ -67,7 +67,7 @@ Type: _List\<[EmailNotificationWithResult](https://github.com/Altinn/altinn-noti
A list of the generated notifications with send result.
Each notification will include the following properties:
- - id: the id of the notification
+ - id: the ID of the notification
- succeeded: a boolean indicating whether the send status is a successful one.
- _recipient_: the contact details of the recipient that the notification is sent to.
- _sendStatus_: the send status of the notification.
diff --git a/content/notifications/send-notifications/developer-guides/get-notification-order-by-id/_index.en.md b/content/notifications/send-notifications/developer-guides/get-notification-order-by-id/_index.en.md
index dcd1ecd80da..34fab91379f 100644
--- a/content/notifications/send-notifications/developer-guides/get-notification-order-by-id/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/get-notification-order-by-id/_index.en.md
@@ -10,7 +10,7 @@ toc: true
GET /order/{id}
-{id} represents the id of the notification order to retrieve details for.
+{id} represents the ID of the notification order to retrieve details for.
## Authentication
@@ -24,7 +24,7 @@ See [Authentication and Authorization](../../../api/#authentication--authorizati
### Response codes
- 200 OK: The notification order was successfully retrieved.
-- 404 Not Found: No order matching the provided id were found. Refer to problem details in response body for further information.
+- 404 Not Found: No order matching the provided ID were found. Refer to problem details in response body for further information.
- 401 Unauthorized: Indicates a missing, invalid or expired authorization header.
- 403 Forbidden: Indicates that required scope or Platform Access Token is missing or invalid.
@@ -41,7 +41,7 @@ Find a short description of each property below.
#### id
Type: _Guid_
-The id of the notification order.
+The ID of the notification order.
#### creator
Type: _string_
@@ -68,6 +68,16 @@ Type: enum [_NotificationChannelExt_](https://github.com/Altinn/altinn-notificat
The notification channel used for the notifications sent can be _Email_ or _Sms_.
+#### ignoreReservation
+Type: _boolean_
+
+Whether an individuals KRR reservation status should be ignored.
+
+#### resourceId
+Type: _string_
+
+The ID of the Altinn resource the notifications should be related to as the ID appears in the Altinn Resource Registry.
+
#### recipients
Type: List<[_RecipientExt_](https://github.com/Altinn/altinn-notifications/blob/main/src/Altinn.Notifications/Models/RecipientExt.cs)>
diff --git a/content/notifications/send-notifications/developer-guides/get-notification-order-status/_index.en.md b/content/notifications/send-notifications/developer-guides/get-notification-order-status/_index.en.md
index 915b7112295..dc1f763b414 100644
--- a/content/notifications/send-notifications/developer-guides/get-notification-order-status/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/get-notification-order-status/_index.en.md
@@ -10,7 +10,7 @@ toc: true
GET /order/{id}/status
-{id} represents the id of the notification order to retrieve status for.
+{id} represents the ID of the notification order to retrieve status for.
## Authentication
@@ -24,7 +24,7 @@ See [Authentication and Authorization](../../../api/#authentication--authorizati
### Response codes
- 200 OK: The notification order status was successfully retrieved.
-- 404 Not Found: No order matching the provided id were found. Refer to problem details in response body for further information.
+- 404 Not Found: No order matching the provided ID were found. Refer to problem details in response body for further information.
- 401 Unauthorized: Indicates a missing, invalid or expired authorization header.
- 403 Forbidden: Indicates that required scope or Platform Access Token is missing or invalid.
@@ -41,7 +41,7 @@ Find a short description of each property below.
#### id
Type: _Guid_
-The id of the notification order.
+The ID of the notification order.
#### sendersReference
Type: _string_
@@ -67,6 +67,16 @@ Type: enum [_NotificationChannel_](https://github.com/Altinn/altinn-notification
The notification channel used for the notifications sent can be _Email_ or _Sms_.
+#### ignoreReservation
+Type: _boolean_
+
+Whether an individuals KRR reservation status should be ignored.
+
+#### resourceId
+Type: _string_
+
+The ID of the Altinn resource the notifications should be related to as the ID appears in the Altinn Resource Registry.
+
#### processingStatus
Type: [_StatusExt_](https://github.com/Altinn/altinn-notifications/blob/main/src/Altinn.Notifications/Models/StatusExt.cs)
diff --git a/content/notifications/send-notifications/developer-guides/get-sms-notifications/_index.en.md b/content/notifications/send-notifications/developer-guides/get-sms-notifications/_index.en.md
index fadb4b4eb5f..f3e6707adb5 100644
--- a/content/notifications/send-notifications/developer-guides/get-sms-notifications/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/get-sms-notifications/_index.en.md
@@ -11,7 +11,7 @@ toc: true
GET /order/{id}/notifications/sms
-{id} represents the id of the notification order to retrieve notifications for.
+{id} represents the ID of the notification order to retrieve notifications for.
## Authentication
@@ -25,7 +25,7 @@ See [Authentication and Authorization](../../../api/#authentication--authorizati
### Response codes
- 200 OK: The sms notifications were successfully retrieved
-- 404 Not Found: No order matching the provided id were found
+- 404 Not Found: No order matching the provided ID were found
Refer to problem details in response body for further information.
- 401 Unauthorized: Indicates a missing, invalid or expired authorization header.
@@ -45,7 +45,7 @@ and serialized as a JSON string.
#### orderId
Type: _Guid_
-The id of the notification order the listed notifications are related to
+The ID of the notification order the listed notifications are related to
#### sendersReference
Type: _string_
@@ -67,7 +67,7 @@ Type: _List\<[SmsNotificationWithResult](https://github.com/Altinn/altinn-notifi
A list of the generated notifications with send result.
Each notification will include the following properties:
- - id: the id of the notification
+ - id: the ID of the notification
- succeeded: a boolean indicating whether the send status is a successful one.
- _recipient_: the contact details of the recipient that the notification is sent to.
- _sendStatus_: the send status of the notification.
diff --git a/content/notifications/send-notifications/developer-guides/send-email-notifications/_index.en.md b/content/notifications/send-notifications/developer-guides/send-email-notifications/_index.en.md
index d1154e33ca5..37160467fea 100644
--- a/content/notifications/send-notifications/developer-guides/send-email-notifications/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/send-email-notifications/_index.en.md
@@ -74,6 +74,12 @@ An internal reference for notification creator to lookup or identify the notific
the future. Could be a case number or another id. It is recommended, but not required,
that the sender's reference is unique within the organization's notification orders.
+#### resourceId
+Type: _string_
+
+The ID of the Altinn resource the notifications should be related to as the ID appears in the Altinn Resource Registry.
+For an Altinn app with ID _{org}/{app}_ the format of the resourceId is `app_{org}_{app}` e.g. app_ttd_apps-test.
+
## Response
### Response codes
@@ -96,7 +102,7 @@ Find a short description of each property below.
#### orderId
Type: _GUID_
-The generated id for the notification order.
+The generated ID for the notification order.
#### recipientLookup\*
diff --git a/content/notifications/send-notifications/developer-guides/send-sms-notifications/_index.en.md b/content/notifications/send-notifications/developer-guides/send-sms-notifications/_index.en.md
index c7537c10759..3b3819f8dbe 100644
--- a/content/notifications/send-notifications/developer-guides/send-sms-notifications/_index.en.md
+++ b/content/notifications/send-notifications/developer-guides/send-sms-notifications/_index.en.md
@@ -67,6 +67,12 @@ An internal reference for notification creator to lookup or identify the notific
the future. Could be a case number or another id. It is recommended, but not required,
that the sender's reference is unique within the organization's notification orders.
+#### resourceId
+Type: _string_
+
+The id of the Altinn resource the notification should be related to as the id appears in the Altinn Resource Registry.
+For an Altinn app the format of the resource is is `app_{org}_{app}` e.g. app_ttd_apps-test.
+
## Response
### Response codes
diff --git a/static/swagger/altinn-notifications-v1.json b/static/swagger/altinn-notifications-v1.json
index 484da17b087..80f29bb4984 100644
--- a/static/swagger/altinn-notifications-v1.json
+++ b/static/swagger/altinn-notifications-v1.json
@@ -1,21 +1,11 @@
{
"openapi": "3.0.1",
"info": {
- "title": "Altinn.Notifications",
- "version": "1.0"
+ "title": "Altinn.Notifications",
+ "version": "1.0"
},
- "servers": [
- {
- "url": "https://platform.tt02.altinn.no/notifications/api/v1",
- "description": "TT02"
- },
- {
- "url": "https://platform.altinn.no/notifications/api/v1",
- "description": "Production"
- }
- ],
"paths": {
- "/orders/email": {
+ "/notifications/api/v1/orders/email": {
"post": {
"tags": [
"EmailNotificationOrders"
@@ -71,7 +61,7 @@
}
}
},
- "/orders/{id}/notifications/email": {
+ "/notifications/api/v1/orders/{id}/notifications/email": {
"get": {
"tags": [
"EmailNotifications"
@@ -112,7 +102,7 @@
}
}
},
- "/metrics": {
+ "/notifications/api/v1/metrics": {
"get": {
"tags": [
"Metrics"
@@ -120,7 +110,7 @@
"summary": "Presents the initial view of the metrics page",
"responses": {
"200": {
- "description": "Success"
+ "description": "OK"
}
}
},
@@ -158,12 +148,12 @@
},
"responses": {
"200": {
- "description": "Success"
+ "description": "OK"
}
}
}
},
- "/orders/{id}": {
+ "/notifications/api/v1/orders/{id}": {
"get": {
"tags": [
"Orders"
@@ -204,7 +194,7 @@
}
}
},
- "/orders": {
+ "/notifications/api/v1/orders": {
"get": {
"tags": [
"Orders"
@@ -241,7 +231,7 @@
}
}
},
- "/orders/{id}/status": {
+ "/notifications/api/v1/orders/{id}/status": {
"get": {
"tags": [
"Orders"
@@ -282,7 +272,7 @@
}
}
},
- "/orders/sms": {
+ "/notifications/api/v1/orders/sms": {
"post": {
"tags": [
"SmsNotificationOrders"
@@ -338,7 +328,7 @@
}
}
},
- "/orders/{id}/notifications/sms": {
+ "/notifications/api/v1/orders/{id}/notifications/sms": {
"get": {
"tags": [
"SmsNotifications"
@@ -391,21 +381,13 @@
"description": "Enum describing available content types for an email."
},
"EmailNotificationOrderRequestExt": {
+ "required": [
+ "body",
+ "recipients",
+ "subject"
+ ],
"type": "object",
"properties": {
- "subject": {
- "type": "string",
- "description": "Gets or sets the subject of the email",
- "nullable": true
- },
- "body": {
- "type": "string",
- "description": "Gets or sets the body of the email",
- "nullable": true
- },
- "contentType": {
- "$ref": "#/components/schemas/EmailContentTypeExt"
- },
"requestedSendTime": {
"type": "string",
"description": "Gets or sets the send time of the email. Defaults to UtcNow",
@@ -421,12 +403,30 @@
"items": {
"$ref": "#/components/schemas/RecipientExt"
},
- "description": "Gets or sets the list of recipients",
- "nullable": true
+ "description": "Gets or sets the list of recipients"
},
"ignoreReservation": {
"type": "boolean",
- "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations"
+ "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations",
+ "nullable": true
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "Gets or sets the id of the resource that the notification is related to",
+ "nullable": true
+ },
+ "subject": {
+ "minLength": 1,
+ "type": "string",
+ "description": "Gets or sets the subject of the email"
+ },
+ "body": {
+ "minLength": 1,
+ "type": "string",
+ "description": "Gets or sets the body of the email"
+ },
+ "contentType": {
+ "$ref": "#/components/schemas/EmailContentTypeExt"
}
},
"additionalProperties": false,
@@ -547,22 +547,27 @@
"properties": {
"id": {
"type": "string",
- "nullable": true
- },
- "creator": {
- "type": "string",
+ "description": "Gets or sets the id of the notification order",
"nullable": true
},
"sendersReference": {
"type": "string",
+ "description": "Gets or sets the senders reference of the notification",
"nullable": true
},
"requestedSendTime": {
"type": "string",
+ "description": "Gets or sets the requested send time of the notification",
"format": "date-time"
},
+ "creator": {
+ "type": "string",
+ "description": "Gets or sets the short name of the creator of the notification order",
+ "nullable": true
+ },
"created": {
"type": "string",
+ "description": "Gets or sets the date and time of when the notification order was created",
"format": "date-time"
},
"notificationChannel": {
@@ -570,7 +575,13 @@
},
"ignoreReservation": {
"type": "boolean",
- "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations"
+ "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations",
+ "nullable": true
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "Gets or sets the id of the resource that the notification is related to",
+ "nullable": true
},
"recipients": {
"type": "array",
@@ -634,27 +645,42 @@
"properties": {
"id": {
"type": "string",
+ "description": "Gets or sets the id of the notification order",
"nullable": true
},
"sendersReference": {
"type": "string",
+ "description": "Gets or sets the senders reference of the notification",
"nullable": true
},
"requestedSendTime": {
"type": "string",
+ "description": "Gets or sets the requested send time of the notification",
"format": "date-time"
},
"creator": {
"type": "string",
+ "description": "Gets or sets the short name of the creator of the notification order",
"nullable": true
},
"created": {
"type": "string",
+ "description": "Gets or sets the date and time of when the notification order was created",
"format": "date-time"
},
"notificationChannel": {
"$ref": "#/components/schemas/NotificationChannelExt"
},
+ "ignoreReservation": {
+ "type": "boolean",
+ "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations",
+ "nullable": true
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "Gets or sets the id of the resource that the notification is related to",
+ "nullable": true
+ },
"processingStatus": {
"$ref": "#/components/schemas/StatusExt"
},
@@ -720,9 +746,9 @@
"description": "Gets or sets the mobile number of the recipient",
"nullable": true
},
- "organisationNumber": {
+ "organizationNumber": {
"type": "string",
- "description": "Gets or sets the organisation number of the recipient",
+ "description": "Gets or sets the organization number of the recipient",
"nullable": true
},
"nationalIdentityNumber": {
@@ -775,21 +801,15 @@
"description": "Enum describing the success rate for recipient lookup"
},
"SmsNotificationOrderRequestExt": {
+ "required": [
+ "body",
+ "recipients"
+ ],
"type": "object",
"properties": {
- "senderNumber": {
- "type": "string",
- "description": "Gets or sets the sender number of the SMS",
- "nullable": true
- },
- "body": {
- "type": "string",
- "description": "Gets or sets the body of the SMS",
- "nullable": true
- },
"requestedSendTime": {
"type": "string",
- "description": "Gets or sets the send time of the SMS. Defaults to UtcNow.",
+ "description": "Gets or sets the send time of the email. Defaults to UtcNow",
"format": "date-time"
},
"sendersReference": {
@@ -802,12 +822,27 @@
"items": {
"$ref": "#/components/schemas/RecipientExt"
},
- "description": "Gets or sets the list of recipients",
- "nullable": true
+ "description": "Gets or sets the list of recipients"
},
"ignoreReservation": {
"type": "boolean",
- "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations"
+ "description": "Gets or sets whether notifications generated by this order should ignore KRR reservations",
+ "nullable": true
+ },
+ "resourceId": {
+ "type": "string",
+ "description": "Gets or sets the id of the resource that the notification is related to",
+ "nullable": true
+ },
+ "senderNumber": {
+ "type": "string",
+ "description": "Gets or sets the sender number of the SMS",
+ "nullable": true
+ },
+ "body": {
+ "minLength": 1,
+ "type": "string",
+ "description": "Gets or sets the body of the SMS"
}
},
"additionalProperties": false,