{"files":{"SKILL.md":"---\nname: amazon-appintegrations-service\ndescription: \"Amazon AppIntegrations Service API skill. Use when working with Amazon AppIntegrations Service for applications, dataIntegrations, eventIntegrations. Covers 23 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Amazon AppIntegrations Service\nAPI version: 2020-07-29\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /applications -- lists applications in the account.\n3. POST /applications -- create first application\n\n## Endpoints\n23 endpoints across 4 groups. See references/api-spec.lap for full details.\n\n### Applications\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /applications | Creates and persists an Application resource. |\n| DELETE | /applications/{ApplicationIdentifier} | Deletes the Application. Only Applications that don't have any Application Associations can be deleted. |\n| GET | /applications/{ApplicationIdentifier} | Get an Application resource. |\n| GET | /applications/{ApplicationIdentifier}/associations | Returns a paginated list of application associations for an application. |\n| GET | /applications | Lists applications in the account. |\n| PATCH | /applications/{ApplicationIdentifier} | Updates and persists an Application resource. |\n\n### DataIntegrations\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /dataIntegrations | Creates and persists a DataIntegration resource.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| POST | /dataIntegrations/{Identifier}/associations | Creates and persists a DataIntegrationAssociation resource. |\n| DELETE | /dataIntegrations/{Identifier} | Deletes the DataIntegration. Only DataIntegrations that don't have any DataIntegrationAssociations can be deleted. Deleting a DataIntegration also deletes the underlying Amazon AppFlow flow and service linked role.   You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| GET | /dataIntegrations/{Identifier} | Returns information about the DataIntegration.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| GET | /dataIntegrations/{Identifier}/associations | Returns a paginated list of DataIntegration associations in the account.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| GET | /dataIntegrations | Returns a paginated list of DataIntegrations in the account.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| PATCH | /dataIntegrations/{Identifier} | Updates the description of a DataIntegration.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API. |\n| PATCH | /dataIntegrations/{Identifier}/associations/{DataIntegrationAssociationIdentifier} | Updates and persists a DataIntegrationAssociation resource.   Updating a DataIntegrationAssociation with ExecutionConfiguration will rerun the on-demand job. |\n\n### EventIntegrations\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /eventIntegrations | Creates an EventIntegration, given a specified name, description, and a reference to an Amazon EventBridge bus in your account and a partner event source that pushes events to that bus. No objects are created in the your account, only metadata that is persisted on the EventIntegration control plane. |\n| DELETE | /eventIntegrations/{Name} | Deletes the specified existing event integration. If the event integration is associated with clients, the request is rejected. |\n| GET | /eventIntegrations/{Name} | Returns information about the event integration. |\n| GET | /eventIntegrations/{Name}/associations | Returns a paginated list of event integration associations in the account. |\n| GET | /eventIntegrations | Returns a paginated list of event integrations in the account. |\n| PATCH | /eventIntegrations/{Name} | Updates the description of an event integration. |\n\n### Tags\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /tags/{resourceArn} | Lists the tags for the specified resource. |\n| POST | /tags/{resourceArn} | Adds the specified tags to the specified resource. |\n| DELETE | /tags/{resourceArn} | Removes the specified tags from the specified resource. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a application?\" -> POST /applications\n- \"Create a dataIntegration?\" -> POST /dataIntegrations\n- \"Create a association?\" -> POST /dataIntegrations/{Identifier}/associations\n- \"Create a eventIntegration?\" -> POST /eventIntegrations\n- \"Delete a application?\" -> DELETE /applications/{ApplicationIdentifier}\n- \"Delete a dataIntegration?\" -> DELETE /dataIntegrations/{Identifier}\n- \"Delete a eventIntegration?\" -> DELETE /eventIntegrations/{Name}\n- \"Get application details?\" -> GET /applications/{ApplicationIdentifier}\n- \"Get dataIntegration details?\" -> GET /dataIntegrations/{Identifier}\n- \"Get eventIntegration details?\" -> GET /eventIntegrations/{Name}\n- \"List all associations?\" -> GET /applications/{ApplicationIdentifier}/associations\n- \"List all applications?\" -> GET /applications\n- \"List all dataIntegrations?\" -> GET /dataIntegrations\n- \"List all eventIntegrations?\" -> GET /eventIntegrations\n- \"Get tag details?\" -> GET /tags/{resourceArn}\n- \"Delete a tag?\" -> DELETE /tags/{resourceArn}\n- \"Partially update a application?\" -> PATCH /applications/{ApplicationIdentifier}\n- \"Partially update a dataIntegration?\" -> PATCH /dataIntegrations/{Identifier}\n- \"Partially update a association?\" -> PATCH /dataIntegrations/{Identifier}/associations/{DataIntegrationAssociationIdentifier}\n- \"Partially update a eventIntegration?\" -> PATCH /eventIntegrations/{Name}\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 AppIntegrations Service\n@version 2020-07-29\n@auth AWS SigV4\n@endpoints 23\n@hint download_for_search\n@toc applications(6), dataIntegrations(8), eventIntegrations(6), tags(3)\n\n@group applications\n@endpoint POST /applications\n@desc Creates and persists an Application resource.\n@required {Name: str, Namespace: str, ApplicationSourceConfig: ApplicationSourceConfig}\n@optional {Description: str, Subscriptions: [Subscription], Publications: [Publication], ClientToken: str, Tags: map<str,str>, Permissions: [str]}\n@returns(200) {Arn: str?, Id: str?}\n\n@endgroup\n\n@group dataIntegrations\n@endpoint POST /dataIntegrations\n@desc Creates and persists a DataIntegration resource.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@required {Name: str, KmsKey: str}\n@optional {Description: str, SourceURI: str, ScheduleConfig: ScheduleConfiguration, Tags: map<str,str>, ClientToken: str, FileConfiguration: FileConfiguration, ObjectConfiguration: map<str,map<str,[str]>>}\n@returns(200) {Arn: str?, Id: str?, Name: str?, Description: str?, KmsKey: str?, SourceURI: str?, ScheduleConfiguration: ScheduleConfiguration?{FirstExecutionFrom: str?, Object: str?, ScheduleExpression: str}, Tags: map<str,str>?, ClientToken: str?, FileConfiguration: FileConfiguration?{Folders: [str], Filters: map<str, [str]>?: any}, ObjectConfiguration: map<str,map<str,[str]>>?}\n\n@endpoint POST /dataIntegrations/{Identifier}/associations\n@desc Creates and persists a DataIntegrationAssociation resource.\n@required {DataIntegrationIdentifier: str}\n@optional {ClientId: str, ObjectConfiguration: map<str,map<str,[str]>>, DestinationURI: str, ClientAssociationMetadata: map<str,str>, ClientToken: str, ExecutionConfiguration: ExecutionConfiguration}\n@returns(200) {DataIntegrationAssociationId: str?, DataIntegrationArn: str?}\n\n@endgroup\n\n@group eventIntegrations\n@endpoint POST /eventIntegrations\n@desc Creates an EventIntegration, given a specified name, description, and a reference to an Amazon EventBridge bus in your account and a partner event source that pushes events to that bus. No objects are created in the your account, only metadata that is persisted on the EventIntegration control plane.\n@required {Name: str, EventFilter: EventFilter, EventBridgeBus: str}\n@optional {Description: str, ClientToken: str, Tags: map<str,str>}\n@returns(200) {EventIntegrationArn: str?}\n\n@endgroup\n\n@group applications\n@endpoint DELETE /applications/{ApplicationIdentifier}\n@desc Deletes the Application. Only Applications that don't have any Application Associations can be deleted.\n@required {Arn: str}\n\n@endgroup\n\n@group dataIntegrations\n@endpoint DELETE /dataIntegrations/{Identifier}\n@desc Deletes the DataIntegration. Only DataIntegrations that don't have any DataIntegrationAssociations can be deleted. Deleting a DataIntegration also deletes the underlying Amazon AppFlow flow and service linked role.   You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@required {DataIntegrationIdentifier: str}\n\n@endgroup\n\n@group eventIntegrations\n@endpoint DELETE /eventIntegrations/{Name}\n@desc Deletes the specified existing event integration. If the event integration is associated with clients, the request is rejected.\n@required {Name: str}\n\n@endgroup\n\n@group applications\n@endpoint GET /applications/{ApplicationIdentifier}\n@desc Get an Application resource.\n@required {Arn: str}\n@returns(200) {Arn: str?, Id: str?, Name: str?, Namespace: str?, Description: str?, ApplicationSourceConfig: ApplicationSourceConfig?{ExternalUrlConfig: ExternalUrlConfig?{AccessUrl: str, ApprovedOrigins: [str]?}}, Subscriptions: [Subscription]?, Publications: [Publication]?, CreatedTime: str(timestamp)?, LastModifiedTime: str(timestamp)?, Tags: map<str,str>?, Permissions: [str]?}\n\n@endgroup\n\n@group dataIntegrations\n@endpoint GET /dataIntegrations/{Identifier}\n@desc Returns information about the DataIntegration.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@required {Identifier: str}\n@returns(200) {Arn: str?, Id: str?, Name: str?, Description: str?, KmsKey: str?, SourceURI: str?, ScheduleConfiguration: ScheduleConfiguration?{FirstExecutionFrom: str?, Object: str?, ScheduleExpression: str}, Tags: map<str,str>?, FileConfiguration: FileConfiguration?{Folders: [str], Filters: map<str, [str]>?: any}, ObjectConfiguration: map<str,map<str,[str]>>?}\n\n@endgroup\n\n@group eventIntegrations\n@endpoint GET /eventIntegrations/{Name}\n@desc Returns information about the event integration.\n@required {Name: str}\n@returns(200) {Name: str?, Description: str?, EventIntegrationArn: str?, EventBridgeBus: str?, EventFilter: EventFilter?{Source: str}, Tags: map<str,str>?}\n\n@endgroup\n\n@group applications\n@endpoint GET /applications/{ApplicationIdentifier}/associations\n@desc Returns a paginated list of application associations for an application.\n@required {ApplicationId: str}\n@optional {nextToken: str, maxResults: int}\n@returns(200) {ApplicationAssociations: [ApplicationAssociationSummary]?, NextToken: str?}\n\n@endpoint GET /applications\n@desc Lists applications in the account.\n@optional {nextToken: str, maxResults: int}\n@returns(200) {Applications: [ApplicationSummary]?, NextToken: str?}\n\n@endgroup\n\n@group dataIntegrations\n@endpoint GET /dataIntegrations/{Identifier}/associations\n@desc Returns a paginated list of DataIntegration associations in the account.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@required {DataIntegrationIdentifier: str}\n@optional {nextToken: str, maxResults: int}\n@returns(200) {DataIntegrationAssociations: [DataIntegrationAssociationSummary]?, NextToken: str?}\n\n@endpoint GET /dataIntegrations\n@desc Returns a paginated list of DataIntegrations in the account.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@optional {nextToken: str, maxResults: int}\n@returns(200) {DataIntegrations: [DataIntegrationSummary]?, NextToken: str?}\n\n@endgroup\n\n@group eventIntegrations\n@endpoint GET /eventIntegrations/{Name}/associations\n@desc Returns a paginated list of event integration associations in the account.\n@required {EventIntegrationName: str}\n@optional {nextToken: str, maxResults: int}\n@returns(200) {EventIntegrationAssociations: [EventIntegrationAssociation]?, NextToken: str?}\n\n@endpoint GET /eventIntegrations\n@desc Returns a paginated list of event integrations in the account.\n@optional {nextToken: str, maxResults: int}\n@returns(200) {EventIntegrations: [EventIntegration]?, NextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{resourceArn}\n@desc Lists the tags for the specified resource.\n@required {resourceArn: str}\n@returns(200) {tags: map<str,str>?}\n\n@endpoint POST /tags/{resourceArn}\n@desc Adds the specified tags to the specified resource.\n@required {resourceArn: str, tags: map<str,str>}\n\n@endpoint DELETE /tags/{resourceArn}\n@desc Removes the specified tags from the specified resource.\n@required {resourceArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group applications\n@endpoint PATCH /applications/{ApplicationIdentifier}\n@desc Updates and persists an Application resource.\n@required {Arn: str}\n@optional {Name: str, Description: str, ApplicationSourceConfig: ApplicationSourceConfig, Subscriptions: [Subscription], Publications: [Publication], Permissions: [str]}\n\n@endgroup\n\n@group dataIntegrations\n@endpoint PATCH /dataIntegrations/{Identifier}\n@desc Updates the description of a DataIntegration.  You cannot create a DataIntegration association for a DataIntegration that has been previously associated. Use a different DataIntegration, or recreate the DataIntegration using the CreateDataIntegration API.\n@required {Identifier: str}\n@optional {Name: str, Description: str}\n\n@endpoint PATCH /dataIntegrations/{Identifier}/associations/{DataIntegrationAssociationIdentifier}\n@desc Updates and persists a DataIntegrationAssociation resource.   Updating a DataIntegrationAssociation with ExecutionConfiguration will rerun the on-demand job.\n@required {DataIntegrationIdentifier: str, DataIntegrationAssociationIdentifier: str, ExecutionConfiguration: ExecutionConfiguration}\n\n@endgroup\n\n@group eventIntegrations\n@endpoint PATCH /eventIntegrations/{Name}\n@desc Updates the description of an event integration.\n@required {Name: str}\n@optional {Description: str}\n\n@endgroup\n\n@end\n"}}