{"files":{"SKILL.md":"---\nname: amazon-personalize-events\ndescription: \"Amazon Personalize Events API skill. Use when working with Amazon Personalize Events for action-interactions, actions, events. Covers 5 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Amazon Personalize Events\nAPI version: 2018-03-22\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. Verify API access with a test request\n3. POST /action-interactions -- create first action-interaction\n\n## Endpoints\n5 endpoints across 5 groups. See references/api-spec.lap for full details.\n\n### Action-interactions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /action-interactions | Records action interaction event data. An action interaction event is an interaction between a user and an action. For example, a user taking an action, such a enrolling in a membership program or downloading your app.  For more information about recording action interactions, see Recording action interaction events. For more information about actions in an Actions dataset, see Actions dataset. |\n\n### Actions\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /actions | Adds one or more actions to an Actions dataset. For more information see Importing actions individually. |\n\n### Events\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /events | Records item interaction event data. For more information see Recording item interaction events. |\n\n### Items\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /items | Adds one or more items to an Items dataset. For more information see Importing items individually. |\n\n### Users\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /users | Adds one or more users to a Users dataset. For more information see Importing users individually. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a action-interaction?\" -> POST /action-interactions\n- \"Create a action?\" -> POST /actions\n- \"Create a event?\" -> POST /events\n- \"Create a item?\" -> POST /items\n- \"Create a user?\" -> POST /users\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Amazon Personalize Events\n@version 2018-03-22\n@auth AWS SigV4\n@endpoints 5\n@toc action-interactions(1), actions(1), events(1), items(1), users(1)\n\n@group action-interactions\n@endpoint POST /action-interactions\n@desc Records action interaction event data. An action interaction event is an interaction between a user and an action. For example, a user taking an action, such a enrolling in a membership program or downloading your app.  For more information about recording action interactions, see Recording action interaction events. For more information about actions in an Actions dataset, see Actions dataset.\n@required {trackingId: str, actionInteractions: [ActionInteraction]}\n\n@endgroup\n\n@group actions\n@endpoint POST /actions\n@desc Adds one or more actions to an Actions dataset. For more information see Importing actions individually.\n@required {datasetArn: str, actions: [Action]}\n\n@endgroup\n\n@group events\n@endpoint POST /events\n@desc Records item interaction event data. For more information see Recording item interaction events.\n@required {trackingId: str, sessionId: str, eventList: [Event]}\n@optional {userId: str}\n\n@endgroup\n\n@group items\n@endpoint POST /items\n@desc Adds one or more items to an Items dataset. For more information see Importing items individually.\n@required {datasetArn: str, items: [Item]}\n\n@endgroup\n\n@group users\n@endpoint POST /users\n@desc Adds one or more users to a Users dataset. For more information see Importing users individually.\n@required {datasetArn: str, users: [User]}\n\n@endgroup\n\n@end\n"}}