Routines Skill Manifest

The following example shows the skill manifest skill.json file for custom triggers for routines.

apis object for routines

The apis object in the skill manifest contains information about the application programming interfaces (APIs) that your skill can use. For the Alexa Routines Trigger Instance API, the API name is routines.

Field Description Type Required

regions

An array of the supported <region> objects. For details, see regions.

Object

Required for UNICAST triggers only

endpoint

The global default endpoint, which can be overridden on a region-by-region basis. For details, see endpoint.

Object

Required for UNICAST triggers only

regions

The regions section contains an array of the <region> objects.

Field Description Type Required

<region>

Two-letter code for the geographic region, such as NA for North America, EU for Europe, and FE for Far East.

enum

Yes

<region>.endpoint

Region-specific endpoint details including Uniform Resource Identifier (URI) and SSL certificate type.

Object

Yes

<region>.endpoint.uri

Region-specific Amazon Resource Name (ARN) for the custom Lambda function or HTTPS URL of the skill.

String

Yes

<region>.endpoint.sslCertificateType

The SSL certificate type for the skill's region-specific HTTPS endpoint. This field is only valid for HTTPS endpoints, not for AWS Lambda ARN. For details, see SSLCerfiticateType enumeration.

String

Required for HTTPS URL only

endpoint

Theendpointsection sets the global default endpoint for events.

Field Description Type Required

uri

Amazon Resource Name (ARN) for your skill's custom Lambda function or HTTPS URL.

String

Yes

sslCertificateType

The SSL certificate type for the HTTPS endpoint of your skill. This field is valid for HTTPS endpoints, not for AWS Lambda ARN. For details, see SSLCerfiticateType enumeration.

String

Required for HTTPS URL only

permissions

Make sure that you include permissions in your manifest. permissions accepts an array of named permissions that your skill can use. You must include at least one permission setting. For valid permission settings, see Skill Manifest Schema permissions.

If you don't include permissions in your skill.json, your skill can't display the Alexa clientID and clientSecret in the developer console. You need the skill's clientID and clientSecret for skill messaging, so you can send out-of-session events to your skill. For details, see Call Alexa Service APIs Out of Session With Node.js.

Was this page helpful?

Last updated: Nov 27, 2023