{"files":{"SKILL.md":"---\nname: amazon-translate\ndescription: \"Amazon Translate API skill. Use when working with Amazon Translate for root. Covers 19 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Amazon Translate\nAPI version: 2017-07-01\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 / -- create first resource\n\n## Endpoints\n19 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Root\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | / | Creates a parallel data resource in Amazon Translate by importing an input file from Amazon S3. Parallel data files contain examples that show how you want segments of text to be translated. By adding parallel data, you can influence the style, tone, and word choice in your translation output. |\n| POST | / | Deletes a parallel data resource in Amazon Translate. |\n| POST | / | A synchronous action that deletes a custom terminology. |\n| POST | / | Gets the properties associated with an asynchronous batch translation job including name, ID, status, source and target languages, input/output S3 buckets, and so on. |\n| POST | / | Provides information about a parallel data resource. |\n| POST | / | Retrieves a custom terminology. |\n| POST | / | Creates or updates a custom terminology, depending on whether one already exists for the given terminology name. Importing a terminology with the same name as an existing one will merge the terminologies based on the chosen merge strategy. The only supported merge strategy is OVERWRITE, where the imported terminology overwrites the existing terminology of the same name. If you import a terminology that overwrites an existing one, the new terminology takes up to 10 minutes to fully propagate. After that, translations have access to the new terminology. |\n| POST | / | Provides a list of languages (RFC-5646 codes and names) that Amazon Translate supports. |\n| POST | / | Provides a list of your parallel data resources in Amazon Translate. |\n| POST | / | Lists all tags associated with a given Amazon Translate resource. For more information, see  Tagging your resources. |\n| POST | / | Provides a list of custom terminologies associated with your account. |\n| POST | / | Gets a list of the batch translation jobs that you have submitted. |\n| POST | / | Starts an asynchronous batch translation job. Use batch translation jobs to translate large volumes of text across multiple documents at once. For batch translation, you can input documents with different source languages (specify auto as the source language). You can specify one or more target languages. Batch translation translates each input document into each of the target languages. For more information, see Asynchronous batch processing. Batch translation jobs can be described with the DescribeTextTranslationJob operation, listed with the ListTextTranslationJobs operation, and stopped with the StopTextTranslationJob operation. |\n| POST | / | Stops an asynchronous batch translation job that is in progress. If the job's state is IN_PROGRESS, the job will be marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state. Otherwise, the job is put into the STOPPED state. Asynchronous batch translation jobs are started with the StartTextTranslationJob operation. You can use the DescribeTextTranslationJob or ListTextTranslationJobs operations to get a batch translation job's JobId. |\n| POST | / | Associates a specific tag with a resource. A tag is a key-value pair that adds as a metadata to a resource. For more information, see  Tagging your resources. |\n| POST | / | Translates the input document from the source language to the target language. This synchronous operation supports text, HTML, or Word documents as the input document. TranslateDocument supports translations from English to any supported language, and from any supported language to English. Therefore, specify either the source language code or the target language code as “en” (English).   If you set the Formality parameter, the request will fail if the target language does not support formality. For a list of target languages that support formality, see Setting formality. |\n| POST | / | Translates input text from the source language to the target language. For a list of available languages and language codes, see Supported languages. |\n| POST | / | Removes a specific tag associated with an Amazon Translate resource. For more information, see  Tagging your resources. |\n| POST | / | Updates a previously created parallel data resource by importing a new input file from Amazon S3. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a resource?\" -> POST /\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 Translate\n@version 2017-07-01\n@auth AWS SigV4\n@endpoints 19\n@toc root(19)\n\n@endpoint POST /\n@desc Creates a parallel data resource in Amazon Translate by importing an input file from Amazon S3. Parallel data files contain examples that show how you want segments of text to be translated. By adding parallel data, you can influence the style, tone, and word choice in your translation output.\n@required {Name: str, ParallelDataConfig: ParallelDataConfig, ClientToken: str}\n@optional {Description: str, EncryptionKey: EncryptionKey, Tags: [Tag]}\n@returns(200) {Name: str?, Status: str?}\n\n@endpoint POST /\n@desc Deletes a parallel data resource in Amazon Translate.\n@required {Name: str}\n@returns(200) {Name: str?, Status: str?}\n\n@endpoint POST /\n@desc A synchronous action that deletes a custom terminology.\n@required {Name: str}\n\n@endpoint POST /\n@desc Gets the properties associated with an asynchronous batch translation job including name, ID, status, source and target languages, input/output S3 buckets, and so on.\n@required {JobId: str}\n@returns(200) {TextTranslationJobProperties: TextTranslationJobProperties?{JobId: str?, JobName: str?, JobStatus: str?, JobDetails: JobDetails?{TranslatedDocumentsCount: int?, DocumentsWithErrorsCount: int?, InputDocumentsCount: int?}, SourceLanguageCode: str?, TargetLanguageCodes: [str]?, TerminologyNames: [str]?, ParallelDataNames: [str]?, Message: str?, SubmittedTime: str(timestamp)?, EndTime: str(timestamp)?, InputDataConfig: InputDataConfig?{S3Uri: str, ContentType: str}, OutputDataConfig: OutputDataConfig?{S3Uri: str, EncryptionKey: EncryptionKey?{Type: str, Id: str}}, DataAccessRoleArn: str?, Settings: TranslationSettings?{Formality: str?, Profanity: str?, Brevity: str?}}}\n\n@endpoint POST /\n@desc Provides information about a parallel data resource.\n@required {Name: str}\n@returns(200) {ParallelDataProperties: ParallelDataProperties?{Name: str?, Arn: str?, Description: str?, Status: str?, SourceLanguageCode: str?, TargetLanguageCodes: [str]?, ParallelDataConfig: ParallelDataConfig?{S3Uri: str?, Format: str?}, Message: str?, ImportedDataSize: int(i64)?, ImportedRecordCount: int(i64)?, FailedRecordCount: int(i64)?, SkippedRecordCount: int(i64)?, EncryptionKey: EncryptionKey?{Type: str, Id: str}, CreatedAt: str(timestamp)?, LastUpdatedAt: str(timestamp)?, LatestUpdateAttemptStatus: str?, LatestUpdateAttemptAt: str(timestamp)?}, DataLocation: ParallelDataDataLocation?{RepositoryType: str, Location: str}, AuxiliaryDataLocation: ParallelDataDataLocation?{RepositoryType: str, Location: str}, LatestUpdateAttemptAuxiliaryDataLocation: ParallelDataDataLocation?{RepositoryType: str, Location: str}}\n\n@endpoint POST /\n@desc Retrieves a custom terminology.\n@required {Name: str}\n@optional {TerminologyDataFormat: str}\n@returns(200) {TerminologyProperties: TerminologyProperties?{Name: str?, Description: str?, Arn: str?, SourceLanguageCode: str?, TargetLanguageCodes: [str]?, EncryptionKey: EncryptionKey?{Type: str, Id: str}, SizeBytes: int?, TermCount: int?, CreatedAt: str(timestamp)?, LastUpdatedAt: str(timestamp)?, Directionality: str?, Message: str?, SkippedTermCount: int?, Format: str?}, TerminologyDataLocation: TerminologyDataLocation?{RepositoryType: str, Location: str}, AuxiliaryDataLocation: TerminologyDataLocation?{RepositoryType: str, Location: str}}\n\n@endpoint POST /\n@desc Creates or updates a custom terminology, depending on whether one already exists for the given terminology name. Importing a terminology with the same name as an existing one will merge the terminologies based on the chosen merge strategy. The only supported merge strategy is OVERWRITE, where the imported terminology overwrites the existing terminology of the same name. If you import a terminology that overwrites an existing one, the new terminology takes up to 10 minutes to fully propagate. After that, translations have access to the new terminology.\n@required {Name: str, MergeStrategy: str, TerminologyData: TerminologyData}\n@optional {Description: str, EncryptionKey: EncryptionKey, Tags: [Tag]}\n@returns(200) {TerminologyProperties: TerminologyProperties?{Name: str?, Description: str?, Arn: str?, SourceLanguageCode: str?, TargetLanguageCodes: [str]?, EncryptionKey: EncryptionKey?{Type: str, Id: str}, SizeBytes: int?, TermCount: int?, CreatedAt: str(timestamp)?, LastUpdatedAt: str(timestamp)?, Directionality: str?, Message: str?, SkippedTermCount: int?, Format: str?}, AuxiliaryDataLocation: TerminologyDataLocation?{RepositoryType: str, Location: str}}\n\n@endpoint POST /\n@desc Provides a list of languages (RFC-5646 codes and names) that Amazon Translate supports.\n@optional {DisplayLanguageCode: str, NextToken: str, MaxResults: int}\n@returns(200) {Languages: [Language]?, DisplayLanguageCode: str?, NextToken: str?}\n\n@endpoint POST /\n@desc Provides a list of your parallel data resources in Amazon Translate.\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {ParallelDataPropertiesList: [ParallelDataProperties]?, NextToken: str?}\n\n@endpoint POST /\n@desc Lists all tags associated with a given Amazon Translate resource. For more information, see  Tagging your resources.\n@required {ResourceArn: str}\n@returns(200) {Tags: [Tag]?}\n\n@endpoint POST /\n@desc Provides a list of custom terminologies associated with your account.\n@optional {NextToken: str, MaxResults: int}\n@returns(200) {TerminologyPropertiesList: [TerminologyProperties]?, NextToken: str?}\n\n@endpoint POST /\n@desc Gets a list of the batch translation jobs that you have submitted.\n@optional {Filter: TextTranslationJobFilter, NextToken: str, MaxResults: int}\n@returns(200) {TextTranslationJobPropertiesList: [TextTranslationJobProperties]?, NextToken: str?}\n\n@endpoint POST /\n@desc Starts an asynchronous batch translation job. Use batch translation jobs to translate large volumes of text across multiple documents at once. For batch translation, you can input documents with different source languages (specify auto as the source language). You can specify one or more target languages. Batch translation translates each input document into each of the target languages. For more information, see Asynchronous batch processing. Batch translation jobs can be described with the DescribeTextTranslationJob operation, listed with the ListTextTranslationJobs operation, and stopped with the StopTextTranslationJob operation.\n@required {InputDataConfig: InputDataConfig, OutputDataConfig: OutputDataConfig, DataAccessRoleArn: str, SourceLanguageCode: str, TargetLanguageCodes: [str], ClientToken: str}\n@optional {JobName: str, TerminologyNames: [str], ParallelDataNames: [str], Settings: TranslationSettings}\n@returns(200) {JobId: str?, JobStatus: str?}\n\n@endpoint POST /\n@desc Stops an asynchronous batch translation job that is in progress. If the job's state is IN_PROGRESS, the job will be marked for termination and put into the STOP_REQUESTED state. If the job completes before it can be stopped, it is put into the COMPLETED state. Otherwise, the job is put into the STOPPED state. Asynchronous batch translation jobs are started with the StartTextTranslationJob operation. You can use the DescribeTextTranslationJob or ListTextTranslationJobs operations to get a batch translation job's JobId.\n@required {JobId: str}\n@returns(200) {JobId: str?, JobStatus: str?}\n\n@endpoint POST /\n@desc Associates a specific tag with a resource. A tag is a key-value pair that adds as a metadata to a resource. For more information, see  Tagging your resources.\n@required {ResourceArn: str, Tags: [Tag]}\n\n@endpoint POST /\n@desc Translates the input document from the source language to the target language. This synchronous operation supports text, HTML, or Word documents as the input document. TranslateDocument supports translations from English to any supported language, and from any supported language to English. Therefore, specify either the source language code or the target language code as “en” (English).   If you set the Formality parameter, the request will fail if the target language does not support formality. For a list of target languages that support formality, see Setting formality.\n@required {Document: Document, SourceLanguageCode: str, TargetLanguageCode: str}\n@optional {TerminologyNames: [str], Settings: TranslationSettings}\n@returns(200) {TranslatedDocument: TranslatedDocument{Content: bytes}, SourceLanguageCode: str, TargetLanguageCode: str, AppliedTerminologies: [AppliedTerminology]?, AppliedSettings: TranslationSettings?{Formality: str?, Profanity: str?, Brevity: str?}}\n\n@endpoint POST /\n@desc Translates input text from the source language to the target language. For a list of available languages and language codes, see Supported languages.\n@required {Text: str, SourceLanguageCode: str, TargetLanguageCode: str}\n@optional {TerminologyNames: [str], Settings: TranslationSettings}\n@returns(200) {TranslatedText: str, SourceLanguageCode: str, TargetLanguageCode: str, AppliedTerminologies: [AppliedTerminology]?, AppliedSettings: TranslationSettings?{Formality: str?, Profanity: str?, Brevity: str?}}\n\n@endpoint POST /\n@desc Removes a specific tag associated with an Amazon Translate resource. For more information, see  Tagging your resources.\n@required {ResourceArn: str, TagKeys: [str]}\n\n@endpoint POST /\n@desc Updates a previously created parallel data resource by importing a new input file from Amazon S3.\n@required {Name: str, ParallelDataConfig: ParallelDataConfig, ClientToken: str}\n@optional {Description: str}\n@returns(200) {Name: str?, Status: str?, LatestUpdateAttemptStatus: str?, LatestUpdateAttemptAt: str(timestamp)?}\n\n@end\n"}}