Run applications asynchronously
With asynchronous applications, your team can build and deploy no-code applications in AI Studio and you can use the async applications API to generate content asynchronously or in batches.
For example, your product team can build a no-code application that creates product description pages, and then you can use the async applications API to generate pages in batches for multiple products.
This guide helps you understand how to run async jobs. The API is similar to the no-code applications API, but it allows you to process batches of content generation requests asynchronously.
You need an API key to access the Writer API. Get an API key by following the steps in the API quickstart.
We recommend setting the API key as an environment variable in a .env
file with the name WRITER_API_KEY
.
Endpoint overview
URL: POST https://api.writer.com/v1/applications/{application_id}/jobs
Path parameters
Parameter | Type | Description |
---|---|---|
application_id | string | The ID of the no-code application |
Request body
The async applications API has the same request body structure as the no-code applications API. It should contain an array of input objects matching the no-code application’s input schema.
Response format
A successful job creation request returns a JSON object with the following structure:
Parameter | Type | Description |
---|---|---|
job_id | string | The ID of the job |
status | string | The status of the job. Can be in_progress , completed , or failed . |
created_at | string | The date and time the job was created |
Usage example
The following example demonstrates using the async applications API to generate content asynchronously with a hypothetical product description generation application.
Create and deploy a no-code application
First, create and deploy a no-code application in AI Studio. If you don’t already have a no-code application, follow the text generation guide to get started.
Create an async job
Send a POST
request with the inputs for the application to create an async job.
Check job status
Use the job ID from the creation response to check the status of your job and see the results.
The response includes the current status. If the job has completed, the results are in the data.suggestion
field, which has the same structure as the no-code applications API.
List all jobs
You can retrieve all jobs for an application to monitor batch processing:
Retry failed jobs
If a job fails, you can retry it using the retry endpoint:
Next steps
By following this guide, you can use the async Applications API to handle large-scale tasks.
Next, learn how to enhance your no-code applications with Knowledge Graph, our tool for RAG.
Was this page helpful?