# Apps resource
> \[!IMPORTANT]
>
> The Push Notifications API is currently available as a
> Private Beta product. The information contained in this document is subject to change. You acknowledge
> and agree that your use of the Twilio Push Notifications API is subject to the terms of the [Services in
> Private Beta](https://www.twilio.com/en-us/legal/service-country-specific-terms/private-beta). This
> means that some features are not yet implemented and others may be changed before the product is
> declared as Generally Available. Private Beta products are not covered by the Twilio Support Terms or
> Twilio Service Level Agreement.
An App resource represents a namespace that associates different [Credentials](/docs/push-notifications/api/credential-resource) with specific [Device Registrations](/docs/push-notifications/api/device-registration-resource). Use Apps to separate registrations and credentials for different environments or applications.
For example, you might have a development App and a production App, or you might offer more than one user-facing application to your customers.
The API creates an App automatically when you [create a Credential](/docs/push-notifications/api/credential-resource#create-a-credential) with an `appName` that doesn't exist yet. If no other Apps exist, the API sets the new App as the default. You can have a maximum of 10 Apps per account.
## App Properties
## Fetch an App
`GET https://comms.twilio.com/v1/PushNotifications/Apps/{appName}`
Retrieve a single App resource by making an HTTP `GET` request to the App resource URI with the App name.
The response includes the App's `defaultCredentials` array, which lists the default credential for each provider type (`APN`, `FCM`).
### Path parameters
```json
[{"schema":{"x-twilio-version":1,"title":"PushNotificationAppName","description":"The name of the Push Notification `App`.","type":"string","pattern":"^[a-z0-9_]+$","minLength":1,"maxLength":64,"refName":"PushNotificationAppName","modelName":""},"x-twilio-version":1,"name":"appName","in":"path","required":true}]
```
### Responses
Fetch a PushNotification App
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "",
authToken: "",
});
await client.pushNotifications.apps.fetch("appName");
}
main();
```
```py
from twilio import TwilioComms
client = TwilioComms(
account_id="",
auth_token="",
)
client.push_notifications.apps.fetch(
app_name="appName",
)
```
```cs
using TwilioComms;
using System.Threading.Tasks;
public partial class Examples
{
public async Task Example() {
var client = new TwilioCommsClient(
accountId: "",
authToken: ""
);
await client.PushNotifications.Apps.FetchAsync(
"appName"
);
}
}
```
```java
package com.example.usage;
import com.twilio.comms.TwilioCommsClient;
public class Example {
public static void main(String[] args) {
TwilioCommsClient client = TwilioCommsClient
.builder()
.credentials("", "")
.build();
client.pushNotifications().apps().fetch("appName");
}
}
```
```go
package example
import (
context "context"
client "github.com/twilio/twilio-comms-go/twilio/client"
option "github.com/twilio/twilio-comms-go/twilio/option"
)
func do() {
client := client.NewWithOptions(
option.WithBasicAuth(
"",
"",
),
)
client.PushNotifications.Apps.Fetch(
context.TODO(),
"appName",
)
}
```
```php
',
authToken: '',
);
$client->pushNotifications->apps->fetch(
'appName',
);
```
```rb
require "twilio"
client = Twilio::Client.new(
account_id: "",
auth_token: ""
)
client.push_notifications.apps.fetch(app_name: "appName")
```
```bash
curl 'https://comms.twilio.com/v1/PushNotifications/Apps/{appName}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```
## List Apps
`GET https://comms.twilio.com/v1/PushNotifications/Apps`
Returns a list of all Apps associated with your account. You can filter by date range or default status.
### Query parameters
```json
[{"in":"query","name":"startDate","description":"Filter to Push Notification Apps created after the specified date and time.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"endDate","description":"Filter to Push Notification Apps created before the specified date and time.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"isDefault","description":"Filter by `App.isDefault`.","schema":{"type":"boolean"}},{"in":"query","name":"pageToken","description":"The token to retrieve the next page of results.","schema":{"x-twilio-version":1,"description":"The token that identifies the page of resources to fetch.","title":"PageToken","type":"string","refName":"PageToken","modelName":""}},{"in":"query","name":"pageSize","description":"The number of resources to return in a page.","schema":{"x-twilio-version":1,"description":"Total number of items returned in a single page, the minimum is 1 and maximum is 1000. Default is 50.","title":"PageSize","type":"integer","minimum":1,"maximum":1000,"default":50,"example":50,"refName":"PageSize","modelName":""}}]
```
### Responses
List PushNotification Apps
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "",
authToken: "",
});
await client.pushNotifications.apps.list({
startDate: new Date("2024-01-15T09:30:00Z"),
endDate: new Date("2024-01-15T09:30:00Z"),
isDefault: true,
pageToken: "pageToken",
pageSize: 50,
});
}
main();
```
```py
from twilio import TwilioComms
import datetime
client = TwilioComms(
account_id="",
auth_token="",
)
client.push_notifications.apps.list(
start_date=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
end_date=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
is_default=True,
page_token="pageToken",
page_size=50,
)
```
```cs
using TwilioComms;
using System.Threading.Tasks;
using TwilioComms.PushNotifications;
using System;
using System.Globalization;
public partial class Examples
{
public async Task Example() {
var client = new TwilioCommsClient(
accountId: "",
authToken: ""
);
await client.PushNotifications.Apps.ListAsync(
new AppsListRequest {
StartDate = DateTime.Parse("2024-01-15T09:30:00Z", null, DateTimeStyles.AdjustToUniversal),
EndDate = DateTime.Parse("2024-01-15T09:30:00Z", null, DateTimeStyles.AdjustToUniversal),
IsDefault = true,
PageToken = "pageToken",
PageSize = 50
}
);
}
}
```
```java
package com.example.usage;
import com.twilio.comms.TwilioCommsClient;
import com.twilio.comms.resources.pushnotifications.apps.requests.AppsListRequest;
import java.time.OffsetDateTime;
public class Example {
public static void main(String[] args) {
TwilioCommsClient client = TwilioCommsClient
.builder()
.credentials("", "")
.build();
client.pushNotifications().apps().list(
AppsListRequest
.builder()
.startDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.endDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.isDefault(true)
.pageToken("pageToken")
.pageSize(50)
.build()
);
}
}
```
```go
package example
import (
context "context"
twiliocomms "github.com/twilio/twilio-comms-go/twilio"
client "github.com/twilio/twilio-comms-go/twilio/client"
option "github.com/twilio/twilio-comms-go/twilio/option"
)
func do() {
client := client.NewWithOptions(
option.WithBasicAuth(
"",
"",
),
)
request := &twiliocomms.AppsListRequest{
StartDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
EndDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
IsDefault: twiliocomms.Bool(
true,
),
PageToken: twiliocomms.String(
"pageToken",
),
PageSize: twiliocomms.Int(
50,
),
}
client.PushNotifications.Apps.List(
context.TODO(),
request,
)
}
```
```php
',
authToken: '',
);
$client->pushNotifications->apps->list(
new AppsListRequest([
'startDate' => new DateTime('2024-01-15T09:30:00Z'),
'endDate' => new DateTime('2024-01-15T09:30:00Z'),
'isDefault' => true,
'pageToken' => 'pageToken',
'pageSize' => 50,
]),
);
```
```rb
require "twilio"
client = Twilio::Client.new(
account_id: "",
auth_token: ""
)
client.push_notifications.apps.list(
start_date: "2024-01-15T09:30:00Z",
end_date: "2024-01-15T09:30:00Z",
is_default: true,
page_token: "pageToken",
page_size: 50
)
```
```bash
curl 'https://comms.twilio.com/v1/PushNotifications/Apps?pageSize=50' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```
## Update an App
`PATCH https://comms.twilio.com/v1/PushNotifications/Apps/{appName}`
Update an existing App by making an HTTP `PATCH` request to the App resource URI with the App name.
Set `isDefault` to `true` to make this App the default App for your account.
### Path parameters
```json
[{"schema":{"x-twilio-version":1,"title":"PushNotificationAppName","description":"The name of the Push Notification `App`.","type":"string","pattern":"^[a-z0-9_]+$","minLength":1,"maxLength":64,"refName":"PushNotificationAppName","modelName":""},"x-twilio-version":1,"name":"appName","in":"path","required":true}]
```
### Request body parameters
```json
{"schema":{"title":"UpdatePushNotificationAppRequest","type":"object","required":["isDefault"],"properties":{"isDefault":{"type":"boolean","description":"Whether this `App` is the default (Push Notification) App for the Account.\n\nSet to `true` to set this `App` as the default `App`."}}},"examples":{"UpdateDefaultApp":{"x-twilio-version":1,"summary":"Update default App","value":{"lang":"json","value":"{\n \"isDefault\": true\n}","meta":"","code":"{\n \"isDefault\": true\n}","tokens":[["{","#C9D1D9"],"\n ",["\"isDefault\"","#7EE787"],[":","#C9D1D9"]," ",["true","#79C0FF"],"\n",["}","#C9D1D9"]],"annotations":[],"themeName":"github-dark","style":{"color":"#c9d1d9","background":"#0d1117"}}}},"encodingType":"application/json","conditionalParameterMap":{}}
```
### Responses
Update a PushNotification App
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "",
authToken: "",
});
await client.pushNotifications.apps.update("appName", {
isDefault: true,
});
}
main();
```
```py
from twilio import TwilioComms
client = TwilioComms(
account_id="",
auth_token="",
)
client.push_notifications.apps.update(
app_name="appName",
is_default=True,
)
```
```cs
using TwilioComms;
using System.Threading.Tasks;
using TwilioComms.PushNotifications;
public partial class Examples
{
public async Task Example() {
var client = new TwilioCommsClient(
accountId: "",
authToken: ""
);
await client.PushNotifications.Apps.UpdateAsync(
"appName",
new AppsUpdateRequest {
IsDefault = true
}
);
}
}
```
```java
package com.example.usage;
import com.twilio.comms.TwilioCommsClient;
import com.twilio.comms.resources.pushnotifications.apps.requests.AppsUpdateRequest;
public class Example {
public static void main(String[] args) {
TwilioCommsClient client = TwilioCommsClient
.builder()
.credentials("", "")
.build();
client.pushNotifications().apps().update(
"appName",
AppsUpdateRequest
.builder()
.isDefault(true)
.build()
);
}
}
```
```go
package example
import (
context "context"
twiliocomms "github.com/twilio/twilio-comms-go/twilio"
client "github.com/twilio/twilio-comms-go/twilio/client"
option "github.com/twilio/twilio-comms-go/twilio/option"
)
func do() {
client := client.NewWithOptions(
option.WithBasicAuth(
"",
"",
),
)
request := &twiliocomms.AppsUpdateRequest{
IsDefault: true,
}
client.PushNotifications.Apps.Update(
context.TODO(),
"appName",
request,
)
}
```
```php
',
authToken: '',
);
$client->pushNotifications->apps->update(
'appName',
new AppsUpdateRequest([
'isDefault' => true,
]),
);
```
```rb
require "twilio"
client = Twilio::Client.new(
account_id: "",
auth_token: ""
)
client.push_notifications.apps.update(
app_name: "appName",
is_default: true
)
```
```bash
curl -X PATCH 'https://comms.twilio.com/v1/PushNotifications/Apps/{appName}' \
--header 'Content-Type: application/json' \
--data '{
"isDefault": true
}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```