AWorld APIs are in a pre-alpha stage and are being updated frequently. For integration inquiries or technical information, please contact us at server@aworld.org.

Submit story completion

POST

https://api.eu-west-1.aworld.cloud/app/v1/stories/{storyId}/submit

Marks a story as completed by the user.
This endpoint tracks user engagement with story content.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Story submitted successfully

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.eu-west-1.aworld.cloud/app/v1/stories//submit' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "action": "START_READ",
    "context": "default",
    "contentId": 0
}'

Response Example

{
    "storyId": "string",
    "userId": "string",
    "lang": "aa",
    "action": "START_READ",
    "context": "default",
    "contentId": 0,
    "accountId": "stringstri",
    "workspaceId": "stringstri",
    "sourceRegion": "us-east-1",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
}

Modified at 2025-10-14 14:40:02

Get story by ID

List streaks