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.

AWorld API

Publish a mission

POST

https://api.eu-west-1.aworld.cloud/dashboard/v1/missions/{missionId}/publish

Missions

Publishes a mission, making it available for use.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.eu-west-1.aworld.cloud/dashboard/v1/missions//publish'

Response Example

{
    "missionId": "string",
    "name": "string",
    "missionType": "INDIVIDUAL",
    "matchType": "INSTANCE",
    "matchEntity": "Activity",
    "matchEntityId": "string",
    "matchCondition": {},
    "incrementExpression": {},
    "targetAmountExpression": {},
    "origin": "CATALOG",
    "missionCatalogId": "string",
    "syncWithCatalog": true,
    "defaultLang": "string",
    "langs": [
        "string"
    ],
    "accountId": "string",
    "workspaceId": "string",
    "sourceRegion": "string",
    "stage": "DRAFT",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

missionId

string

required

Unique identifier of the mission to publish.

Responses

🟢200OK

application/json

Mission published successfully.

Body

Mission entity representing a set of tasks or objectives for users.

missionId

string

required

Unique identifier for the mission (NanoID).

name

string

required

Name of the mission.

missionType

enum<string>

required

Type of mission (individual or group-based).

Allowed values:

INDIVIDUALGROUP

matchType

enum<string>

required

Determines how the mission's conditions are matched.

Allowed values:

INSTANCEENTITYTAG

matchEntity

enum<string>

required

The entity type the mission's conditions apply to.

Allowed values:

ActivityQuizTag

matchEntityId

string

optional

Specific entity ID for matching (if applicable).

matchCondition

JsonLogicExpression

required

JSON Logic expression defining the refining conditions that defines if the matched entity contributes to mission progress. Evaluated against: { mission }.

One of

object

number

boolean

Object representation of a JSON Logic rule

incrementExpression

JsonLogicExpression

required

JSON Logic expression defining how progress is incremented.

One of

object

number

boolean

Object representation of a JSON Logic rule

targetAmountExpression

JsonLogicExpression

required

JSON Logic expression defining the target amount for mission completion. Evaluated against: { mission, user? } (user is optional and only present for INDIVIDUAL missions).

One of

object

number

boolean

Object representation of a JSON Logic rule

origin

enum<string>

required

Indicates if the mission is from a catalog or custom-created.

Allowed values:

CATALOGCUSTOM

missionCatalogId

string

optional

ID of the mission in the catalog (if applicable).

syncWithCatalog

boolean

optional

Whether the mission should sync with catalog updates.

defaultLang

string

required

Default language code for the mission's content.

langs

array[string]

required

List of available language codes for this mission.

accountId

string

optional

The account ID that owns this mission.

workspaceId

string

optional

The workspace ID that contains this mission.

sourceRegion

string

optional

AWS region where the mission was created.

stage

enum<string>

optional

Current publication stage of the mission.

Allowed values:

DRAFTPUBLISHED

createdAt

string <date-time>

required

Timestamp when the mission was created.

updatedAt

string <date-time>

required

Timestamp when the mission was last updated.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Modified at 2025-06-26 12:45:55

Update mission

List mission rules