> ## Documentation Index > Fetch the complete documentation index at: https://adp-doc.laiye.com/llms.txt > Use this file to discover all available pages before exploring further. # Create asynchronous document conversion task > Create a document conversion task and return its `task_id` immediately. Queue messages are currently retained for approximately one hour, a task consumer times out after approximately 180 seconds, and result files are generally valid for approximately one hour. These durations are not stable SLAs. Creation failure may still appear as HTTP 200 with `code=success` and `data=null`. Require a non-empty `data.task_id`, then poll the query endpoint with a backoff strategy. ## OpenAPI ````yaml en/api-reference/adp-api.yaml POST /open/agentic_doc_processor/{tenant_name}/v1/doc/convert/create/task openapi: 3.1.0 info: title: ADP API version: 1.0.0 description: >- Laiye ADP OpenAPI reference for document extraction, recognition, and conversion; extraction application management; webhooks; human collaboration; credit usage; workflow discovery, runs, exports, and file management. license: name: MIT identifier: MIT servers: - url: https://adp-global.laiye.com description: ADP global production endpoint security: [] tags: - name: Document extraction description: Extract structured fields from uploaded documents. - name: Document recognition description: Recognize text, layout blocks, and positions from uploaded documents. - name: Document conversion description: >- Convert PDFs, Office documents, OFD files, and images into page images or native spreadsheet structures. - name: Application management description: >- Create, update, delete, and query extraction applications and configurations. - name: Webhook description: List system events and manage event callbacks. - name: Account description: Query credit usage. - name: Workflow description: >- List business workflow templates, run workflow applications, and query run results. - name: Workflow files description: Upload and manage files used by workflow applications. - name: Human collaboration description: >- Configure review triggers, query collaboration tasks, and submit human corrections. paths: /open/agentic_doc_processor/{tenant_name}/v1/doc/convert/create/task: post: tags: - Document conversion summary: Create asynchronous document conversion task description: > Create a document conversion task and return its `task_id` immediately. Queue messages are currently retained for approximately one hour, a task consumer times out after approximately 180 seconds, and result files are generally valid for approximately one hour. These durations are not stable SLAs. Creation failure may still appear as HTTP 200 with `code=success` and `data=null`. Require a non-empty `data.task_id`, then poll the query endpoint with a backoff strategy. operationId: createDocumentConvertTask parameters: - $ref: '#/components/parameters/TenantName' requestBody: $ref: '#/components/requestBodies/DocumentConvertAsyncRequest' responses: '200': $ref: '#/components/responses/DocumentConvertTaskResponse' '422': $ref: '#/components/responses/ValidationError' security: - ApiKeyAuth: [] components: parameters: TenantName: name: tenant_name in: path required: true description: 'Tenant name. Default: laiye.' schema: type: string default: laiye requestBodies: DocumentConvertAsyncRequest: required: true content: application/json: schema: $ref: '#/components/schemas/DocumentConvertAsyncRequest' example: file_url: https://example.com/long-document.pdf first_convert_page: 1 last_convert_page: 20 responses: DocumentConvertTaskResponse: description: Asynchronous document conversion task creation result. content: application/json: schema: $ref: '#/components/schemas/DocumentConvertTaskResponse' examples: created: value: code: success message: '' tips: null data: task_id: task_abc123 failedButWrappedAsSuccess: summary: Response that may be returned by the current failure branch value: code: success message: '' tips: null data: null ValidationError: description: Validation error. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' example: detail: - type: greater_than loc: - query - limit msg: Input should be greater than 0 input: 0 ctx: gt: 0 schemas: DocumentConvertAsyncRequest: type: object additionalProperties: false oneOf: - title: Use file URL required: - file_url - title: Use Base64 file required: - file_base64 properties: file_url: type: string format: uri maxLength: 2048 description: Public HTTPS URL of the file to convert. file_base64: type: string format: byte description: >- Base64 content of the file to convert. The decoded file can be at most 50 MiB. scale: type: number exclusiveMinimum: 0 default: 1 first_convert_page: type: integer minimum: 1 last_convert_page: type: integer minimum: 1 description: >- Asynchronous conversion currently always returns page results as URLs. The backend ignores `result_mode`, so the public contract does not expose that field. DocumentConvertTaskResponse: allOf: - $ref: '#/components/schemas/SimpleResponse' - type: object properties: data: oneOf: - type: object properties: task_id: type: string required: - task_id - type: 'null' HTTPValidationError: type: object description: FastAPI/Pydantic request validation error. properties: detail: type: array items: $ref: '#/components/schemas/ValidationErrorItem' required: - detail SimpleResponse: type: object properties: code: oneOf: - type: string - type: integer description: Business code. A successful response is usually success or 200. message: type: string description: Response message. tips: type: - string - 'null' description: Details. Defaults to null. ValidationErrorItem: type: object additionalProperties: true properties: type: type: string description: Validation error type. loc: type: array description: Location of the invalid field in the request. items: oneOf: - type: string - type: integer msg: type: string description: Human-readable validation error message. input: description: Input value that failed validation. ctx: type: object additionalProperties: true description: Additional context supplied by the validator. url: type: string format: uri description: Link to the Pydantic error documentation. required: - type - loc - msg securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY description: >- Production API Key. You can find it under My API in the ADP platform. Make sure the API Key is active and belongs to the production environment. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.