Skip to content

Exports

Export endpoints retrieve project data in Arcweave JSON or an engine-specific format.

Rate limits

Project imports and exports share a workspace quota of 3 requests per minute per purchased seat. Export requests, including HEAD requests, also count toward the overall API quota of 60 requests per minute per purchased seat. See Rate limits for seat allowances, shared quotas, and retry guidance.

For all export endpoints, send locale as a single language-code string and boolean query parameters as true or false. Only lowercase allLocales=true enables all languages; allLocales=1 does not. An array for locale or an unrecognized allLocales value returns 400 Bad Request with field errors. Engine exports also reject invalid fallbackContents values with the same response.

Endpoints

JSON export # GET/api/v1/{hash}/json

Request

http
GET /api/v1/{hash}/json
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/json"

Response

Returns 200 OK.

The response matches the project's Arcweave JSON export.

Query parameters

All JSON export query parameters are optional:

ParameterValueBehaviorWhen omitted
boardIds[]Board IDLimits the export to selected boards. Repeat the parameter for multiple boards.The export includes all project boards.
localeLanguage ISO codeExports localized content for the specified language, for example es.The export uses the project's default language.
allLocalesBooleanWhen true, exports all available languages. This overrides locale when both parameters are supplied.Defaults to false; the locale behavior applies.

Retrieve the full project in its default language:

http
GET /api/v1/{hash}/json
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/json"

Retrieve the full project in Spanish:

http
GET /api/v1/{hash}/json?locale=es
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/json?locale=es"

Retrieve two boards in Spanish:

http
GET /api/v1/{hash}/json?boardIds[]=board_1&boardIds[]=board_2&locale=es
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/json?boardIds%5B%5D=board_1&boardIds%5B%5D=board_2&locale=es"

boardIds must be an array of board ID strings. A non-array value or a nested array entry returns 400 Bad Request.

Retrieve the full project in all available languages:

http
GET /api/v1/{hash}/json?allLocales=true
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/json?allLocales=true"

Deprecated asset filename header

AW-No-Filter-Asset-Names is deprecated and will be removed soon. New integrations should use the dedicated asset endpoints, and existing integrations should migrate to them.

The header exposes stored asset filenames in JSON and Godot exports:

http
AW-No-Filter-Asset-Names: true

Use the dedicated asset endpoints instead:

  1. Read the asset IDs from the export's assets object.
  2. Retrieve an asset's metadata and stored filename with GET /asset/{assetID}.
  3. Retrieve its binary file with GET /asset/{assetID}/file.

Export for Unity # GET/api/v1/{hash}/unity

Request

http
GET /api/v1/{hash}/unity
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/unity"

Response

Returns 200 OK.

Returns the project format used by the Arcweave Unity integration.

Query parameterTypeDescription
localeLanguage ISO codeExport content for one language.
allLocalesBooleanExport all languages and override locale.
fallbackContentsBooleanUse fallback localized content when the selected language has no value.

Export for Unreal Engine # GET/api/v1/{hash}/unreal

Request

http
GET /api/v1/{hash}/unreal
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/unreal"

Response

Returns 200 OK.

Returns the project format used by the Arcweave Unreal Engine integration.

Query parameterTypeDescription
localeLanguage ISO codeExport content for one language.
allLocalesBooleanExport all languages and override locale.
fallbackContentsBooleanUse fallback localized content when the selected language has no value.

Export for Godot # GET/api/v1/{hash}/godot

Request

http
GET /api/v1/{hash}/godot
bash
curl --request GET \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Accept: application/json" \
  "https://arcweave.com/api/v1/PROJECT_HASH/godot"

Response

Returns 200 OK.

Returns the project format used by the Arcweave Godot integration.

Query parameterTypeDescription
localeLanguage ISO codeExport content for one language.
allLocalesBooleanExport all languages and override locale.
fallbackContentsBooleanUse fallback localized content when the selected language has no value.

Deprecated asset filename header

AW-No-Filter-Asset-Names is deprecated and will be removed soon. New integrations should use the dedicated asset endpoints, and existing integrations should migrate to them.

Common errors

StatusMeaning
400Invalid export query.
403Export feature, project access, or permission denied.
404Project not found.
500Export failed unexpectedly.