@athenaintel/sdk 4.3.2297 → 4.3.2298

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
43
43
  const headers = (0, headers_js_1.mergeHeaders)({
44
44
  "X-Fern-Language": "JavaScript",
45
45
  "X-Fern-SDK-Name": "@athenaintel/sdk",
46
- "X-Fern-SDK-Version": "4.3.2297",
47
- "User-Agent": "@athenaintel/sdk/4.3.2297",
46
+ "X-Fern-SDK-Version": "4.3.2298",
47
+ "User-Agent": "@athenaintel/sdk/4.3.2298",
48
48
  "X-Fern-Runtime": core.RUNTIME.type,
49
49
  "X-Fern-Runtime-Version": core.RUNTIME.version,
50
50
  "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,
@@ -74,7 +74,7 @@ export declare class AssetsClient {
74
74
  create(request: AthenaIntelligence.CreateAssetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CreateAssetResponseOut>;
75
75
  private __create;
76
76
  /**
77
- * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). Nothing is left behind when the import fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, and a presentation takes the create_presentation_pptx_studio tool policy.
77
+ * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). A Markdown (.md, .markdown) or plain-text (.txt, .text) file becomes an Athena document, its Markdown rendered (headings, lists, tables, links) and plain text one paragraph per line, and an HTML (.html, .htm) file becomes a user interface: Athena stores the file and converts it in place in the request, as the app's Convert to does, so the original upload stays downloadable from the new asset's Versions pane. A Markdown or text file may be up to 2 MiB and an HTML file up to 5 MiB. Nothing is left behind when the import or conversion fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, a presentation takes the create_presentation_pptx_studio tool policy and a user interface the create_new_user_interface tool policy.
78
78
  *
79
79
  * @param {AthenaIntelligence.BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost} request
80
80
  * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -82,9 +82,11 @@ export declare class AssetsClient {
82
82
  * @throws {@link AthenaIntelligence.BadRequestError}
83
83
  * @throws {@link AthenaIntelligence.ForbiddenError}
84
84
  * @throws {@link AthenaIntelligence.NotFoundError}
85
+ * @throws {@link AthenaIntelligence.ConflictError}
85
86
  * @throws {@link AthenaIntelligence.ContentTooLargeError}
86
87
  * @throws {@link AthenaIntelligence.UnprocessableEntityError}
87
88
  * @throws {@link AthenaIntelligence.BadGatewayError}
89
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
88
90
  *
89
91
  * @example
90
92
  * import { createReadStream } from "fs";
@@ -357,7 +357,7 @@ class AssetsClient {
357
357
  });
358
358
  }
359
359
  /**
360
- * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). Nothing is left behind when the import fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, and a presentation takes the create_presentation_pptx_studio tool policy.
360
+ * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). A Markdown (.md, .markdown) or plain-text (.txt, .text) file becomes an Athena document, its Markdown rendered (headings, lists, tables, links) and plain text one paragraph per line, and an HTML (.html, .htm) file becomes a user interface: Athena stores the file and converts it in place in the request, as the app's Convert to does, so the original upload stays downloadable from the new asset's Versions pane. A Markdown or text file may be up to 2 MiB and an HTML file up to 5 MiB. Nothing is left behind when the import or conversion fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, a presentation takes the create_presentation_pptx_studio tool policy and a user interface the create_new_user_interface tool policy.
361
361
  *
362
362
  * @param {AthenaIntelligence.BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost} request
363
363
  * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -365,9 +365,11 @@ class AssetsClient {
365
365
  * @throws {@link AthenaIntelligence.BadRequestError}
366
366
  * @throws {@link AthenaIntelligence.ForbiddenError}
367
367
  * @throws {@link AthenaIntelligence.NotFoundError}
368
+ * @throws {@link AthenaIntelligence.ConflictError}
368
369
  * @throws {@link AthenaIntelligence.ContentTooLargeError}
369
370
  * @throws {@link AthenaIntelligence.UnprocessableEntityError}
370
371
  * @throws {@link AthenaIntelligence.BadGatewayError}
372
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
371
373
  *
372
374
  * @example
373
375
  * import { createReadStream } from "fs";
@@ -427,12 +429,16 @@ class AssetsClient {
427
429
  throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
428
430
  case 404:
429
431
  throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
432
+ case 409:
433
+ throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
430
434
  case 413:
431
435
  throw new AthenaIntelligence.ContentTooLargeError(_response.error.body, _response.rawResponse);
432
436
  case 422:
433
437
  throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
434
438
  case 502:
435
439
  throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
440
+ case 503:
441
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
436
442
  default:
437
443
  throw new errors.AthenaIntelligenceError({
438
444
  statusCode: _response.error.statusCode,
@@ -14,6 +14,6 @@ export interface BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost {
14
14
  workspace_id?: string | null;
15
15
  /** An asset you can read that the file came from; without parent_folder_id the new asset goes next to it when you may create there */
16
16
  source_asset_id?: string | null;
17
- /** The .docx, .pptx or .potx file to create the asset from */
17
+ /** The .docx, .pptx, .potx, .md, .markdown, .txt, .text, .html or .htm file to create the asset from */
18
18
  file: core.file.Uploadable;
19
19
  }
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2297";
1
+ export declare const SDK_VERSION = "4.3.2298";
@@ -1,4 +1,4 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SDK_VERSION = void 0;
4
- exports.SDK_VERSION = "4.3.2297";
4
+ exports.SDK_VERSION = "4.3.2298";
@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
6
6
  const headers = mergeHeaders({
7
7
  "X-Fern-Language": "JavaScript",
8
8
  "X-Fern-SDK-Name": "@athenaintel/sdk",
9
- "X-Fern-SDK-Version": "4.3.2297",
10
- "User-Agent": "@athenaintel/sdk/4.3.2297",
9
+ "X-Fern-SDK-Version": "4.3.2298",
10
+ "User-Agent": "@athenaintel/sdk/4.3.2298",
11
11
  "X-Fern-Runtime": core.RUNTIME.type,
12
12
  "X-Fern-Runtime-Version": core.RUNTIME.version,
13
13
  "X-Athena-Session-Credential": options === null || options === void 0 ? void 0 : options.sessionCredential,
@@ -74,7 +74,7 @@ export declare class AssetsClient {
74
74
  create(request: AthenaIntelligence.CreateAssetRequestIn, requestOptions?: AssetsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.CreateAssetResponseOut>;
75
75
  private __create;
76
76
  /**
77
- * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). Nothing is left behind when the import fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, and a presentation takes the create_presentation_pptx_studio tool policy.
77
+ * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). A Markdown (.md, .markdown) or plain-text (.txt, .text) file becomes an Athena document, its Markdown rendered (headings, lists, tables, links) and plain text one paragraph per line, and an HTML (.html, .htm) file becomes a user interface: Athena stores the file and converts it in place in the request, as the app's Convert to does, so the original upload stays downloadable from the new asset's Versions pane. A Markdown or text file may be up to 2 MiB and an HTML file up to 5 MiB. Nothing is left behind when the import or conversion fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, a presentation takes the create_presentation_pptx_studio tool policy and a user interface the create_new_user_interface tool policy.
78
78
  *
79
79
  * @param {AthenaIntelligence.BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost} request
80
80
  * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -82,9 +82,11 @@ export declare class AssetsClient {
82
82
  * @throws {@link AthenaIntelligence.BadRequestError}
83
83
  * @throws {@link AthenaIntelligence.ForbiddenError}
84
84
  * @throws {@link AthenaIntelligence.NotFoundError}
85
+ * @throws {@link AthenaIntelligence.ConflictError}
85
86
  * @throws {@link AthenaIntelligence.ContentTooLargeError}
86
87
  * @throws {@link AthenaIntelligence.UnprocessableEntityError}
87
88
  * @throws {@link AthenaIntelligence.BadGatewayError}
89
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
88
90
  *
89
91
  * @example
90
92
  * import { createReadStream } from "fs";
@@ -321,7 +321,7 @@ export class AssetsClient {
321
321
  });
322
322
  }
323
323
  /**
324
- * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). Nothing is left behind when the import fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, and a presentation takes the create_presentation_pptx_studio tool policy.
324
+ * Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). A Markdown (.md, .markdown) or plain-text (.txt, .text) file becomes an Athena document, its Markdown rendered (headings, lists, tables, links) and plain text one paragraph per line, and an HTML (.html, .htm) file becomes a user interface: Athena stores the file and converts it in place in the request, as the app's Convert to does, so the original upload stays downloadable from the new asset's Versions pane. A Markdown or text file may be up to 2 MiB and an HTML file up to 5 MiB. Nothing is left behind when the import or conversion fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, a presentation takes the create_presentation_pptx_studio tool policy and a user interface the create_new_user_interface tool policy.
325
325
  *
326
326
  * @param {AthenaIntelligence.BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost} request
327
327
  * @param {AssetsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -329,9 +329,11 @@ export class AssetsClient {
329
329
  * @throws {@link AthenaIntelligence.BadRequestError}
330
330
  * @throws {@link AthenaIntelligence.ForbiddenError}
331
331
  * @throws {@link AthenaIntelligence.NotFoundError}
332
+ * @throws {@link AthenaIntelligence.ConflictError}
332
333
  * @throws {@link AthenaIntelligence.ContentTooLargeError}
333
334
  * @throws {@link AthenaIntelligence.UnprocessableEntityError}
334
335
  * @throws {@link AthenaIntelligence.BadGatewayError}
336
+ * @throws {@link AthenaIntelligence.ServiceUnavailableError}
335
337
  *
336
338
  * @example
337
339
  * import { createReadStream } from "fs";
@@ -391,12 +393,16 @@ export class AssetsClient {
391
393
  throw new AthenaIntelligence.ForbiddenError(_response.error.body, _response.rawResponse);
392
394
  case 404:
393
395
  throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
396
+ case 409:
397
+ throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
394
398
  case 413:
395
399
  throw new AthenaIntelligence.ContentTooLargeError(_response.error.body, _response.rawResponse);
396
400
  case 422:
397
401
  throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
398
402
  case 502:
399
403
  throw new AthenaIntelligence.BadGatewayError(_response.error.body, _response.rawResponse);
404
+ case 503:
405
+ throw new AthenaIntelligence.ServiceUnavailableError(_response.error.body, _response.rawResponse);
400
406
  default:
401
407
  throw new errors.AthenaIntelligenceError({
402
408
  statusCode: _response.error.statusCode,
@@ -14,6 +14,6 @@ export interface BodyCreateAssetFromFilePublicApiV0AssetsCreateFromFilePost {
14
14
  workspace_id?: string | null;
15
15
  /** An asset you can read that the file came from; without parent_folder_id the new asset goes next to it when you may create there */
16
16
  source_asset_id?: string | null;
17
- /** The .docx, .pptx or .potx file to create the asset from */
17
+ /** The .docx, .pptx, .potx, .md, .markdown, .txt, .text, .html or .htm file to create the asset from */
18
18
  file: core.file.Uploadable;
19
19
  }
@@ -1 +1 @@
1
- export declare const SDK_VERSION = "4.3.2297";
1
+ export declare const SDK_VERSION = "4.3.2298";
@@ -1 +1 @@
1
- export const SDK_VERSION = "4.3.2297";
1
+ export const SDK_VERSION = "4.3.2298";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@athenaintel/sdk",
3
- "version": "4.3.2297",
3
+ "version": "4.3.2298",
4
4
  "private": false,
5
5
  "repository": "github:Athena-Intel/athena-typescript",
6
6
  "type": "commonjs",
package/reference.md CHANGED
@@ -715,7 +715,7 @@ await client.assets.create({
715
715
  <dl>
716
716
  <dd>
717
717
 
718
- Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). Nothing is left behind when the import fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, and a presentation takes the create_presentation_pptx_studio tool policy.
718
+ Create a Word document from a .docx file, or a presentation from a .pptx or .potx file, holding that file's content: the asset Athena makes when you create one from a file in the app. Athena imports the file through DOCX Studio or PPTX Studio with its own studio credential, as your write, and answers once the asset is ready (a large deck can take a few minutes). A Markdown (.md, .markdown) or plain-text (.txt, .text) file becomes an Athena document, its Markdown rendered (headings, lists, tables, links) and plain text one paragraph per line, and an HTML (.html, .htm) file becomes a user interface: Athena stores the file and converts it in place in the request, as the app's Convert to does, so the original upload stays downloadable from the new asset's Versions pane. A Markdown or text file may be up to 2 MiB and an HTML file up to 5 MiB. Nothing is left behind when the import or conversion fails. The file's name decides the type; the title defaults to the name without its extension. Gates are those of POST /api/v0/assets/create: membership in the workspace (workspace_id, else parent_folder_id's, else your current one) and EDIT on parent_folder_id. With source_asset_id (an asset you can read, for example the document the file was exported from) and no parent_folder_id, the new asset goes into the source's folder when you may create there, otherwise at your root. Unlike POST /api/v0/tools/file/save, which stores the file itself and turns an Office upload into its editable type in the background, this makes the editable asset in the request and keeps no file asset. A Word file may be up to 100 MB, Word for the web's limit, a PowerPoint file up to 100 MiB. A Word file gets the app's upload checks before anything is created, and one it refuses answers 422 with detail {code, message}: code is password_protected, rights_managed, damaged (unreadable content, which File > Import in the app can recover), format_mismatch (a template or macro-enabled file named .docx), not_ooxml, too_large or uncompressed_too_large, and message says why in Word's words. From an agent run (a verified X-Athena-Session-Credential), a Word document's first write also records the run, a presentation takes the create_presentation_pptx_studio tool policy and a user interface the create_new_user_interface tool policy.
719
719
  </dd>
720
720
  </dl>
721
721
  </dd>