# Akamai EdgeWorkers API API > Akamai EdgeWorkers API API on Apizie: 40 endpoints (List contract IDs, List permission groups, Get a permission group, List EdgeWorker IDs, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:akamai-edgeworkers/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month. - Project key: `cloud:akamai-edgeworkers` - Category: Cloud - Status: byok - Source: https://techdocs.akamai.com/home/page/apis - Page: https://www.apizie.tech/api/cloud/akamai-edgeworkers - OpenAPI: https://www.apizie.tech/api/cloud/akamai-edgeworkers/openapi.json ## Endpoints ### List contract IDs `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-contracts` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List permission groups `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-groups` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Get a permission group `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-group` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | groupId | number | yes | Unique identifier for an EdgeWorker group. You can pass in plain integer IDs, or add a `grp_` prefix. The Property Manager API supports… | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List EdgeWorker IDs `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-ids` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | groupId | integer | no | Unique identifier for the Akamai group containing the EdgeWorker. | | resourceTierId | integer | no | Unique identifier of the resource tier. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Create a new EdgeWorker ID `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-ids` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Get an EdgeWorker ID `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-id` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Update an EdgeWorker ID `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/put-id` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Delete an EdgeWorker ID `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/delete-id` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List activations `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-activations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | version | string | no | Unique identifier for a specific EdgeWorker version. | | activeOnNetwork | boolean | no | When enabled, limits results to show only currently activate versions. Pair this with a `network` to get the version that's currently… | | network | string | no | __Enum__ When enabled, limits results to show only versions activated on a specific network, either `STAGING` or `PRODUCTION`. Pair this… | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Activate an EdgeWorker version `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-activations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Roll back to the previous active EdgeWorker version `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-rollback-to-previous-active-version` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Get an activation `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-activation` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | activationId | integer | yes | Unique identifier for an EdgeWorkers activation. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Cancel an activation `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/delete-activation` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | activationId | integer | yes | Unique identifier for an EdgeWorkers activation. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Clone an EdgeWorker ID `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-id-clone` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### List deactivations `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-deactivations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | version | string | no | Unique identifier for a specific EdgeWorker version. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Deactivate an EdgeWorker version `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-deactivations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Get a deactivation `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-deactivation` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | deactivationId | integer | yes | Unique identifier for an EdgeWorker deactivation. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List properties `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-properties` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | activeOnly | boolean | no | When enabled, limits results to active properties. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Get the resource tier `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-id-resource-tier` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List revisions `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-revisions` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | version | string | no | Unique identifier for a specific EdgeWorker version. | | activationId | integer | no | Filters results to a specific activation. | | network | string | no | __Enum__ The network on which to use this authentication token, either `STAGING` or `PRODUCTION`. If not specified, the token is created… | | pinnedOnly | boolean | no | When enabled, limits results to show only currently or previously pinned revisions. | | currentlyPinned | boolean | no | When enabled, limits results to show only revisions that are currently pinned. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List revision activations `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-revision-activations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | version | string | no | Unique identifier for a specific EdgeWorker version. | | activationId | integer | no | Filters results to a specific activation. | | network | string | no | __Enum__ The network on which to use this authentication token, either `STAGING` or `PRODUCTION`. If not specified, the token is created… | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Activate a fallback revision `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-revision-activations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Get a revision `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-revision` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Get a revision BOM `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-revision-bom` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | includeActiveVersions | boolean | no | When enabled, limits results to show only active versions. | | includePinnedRevisions | boolean | no | When enabled, limits results to show only the pinned revisions when the BOM was created. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Compare revisions `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-revision-compare` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Download the combined code bundle `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-revision-content` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Pin an active revision `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-revision-pin` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Unpin an active revision `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-revision-unpin` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | revisionId | string | yes | Unique identifier for an EdgeWorkers revision. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### List versions `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-versions` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Create a new version `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-versions` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Get version details `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-version` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | version | integer | yes | Unique identifier for an EdgeWorker version. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Delete version `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/delete-version` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | version | integer | yes | Unique identifier for an EdgeWorker version. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Download an EdgeWorkers code bundle `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-version-content` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | version | integer | yes | Unique identifier for an EdgeWorker version. | | edgeWorkerId | integer | yes | Unique identifier for an EdgeWorker. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List limits `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-limits` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List reports `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-reports` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Get an EdgeWorker report `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-report` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | reportId | integer | yes | Unique identifier of an EdgeWorker report. | | start | string | yes | ISO 8601 timestamp indicating the start time of the EdgeWorker report. | | end | string | yes | ISO 8601 timestamp indicating the end time of the EdgeWorker report. If not specified, the end time defaults to the current time. | | edgeWorker | string | yes | Filter by EdgeWorker ID such as `42` or more specific version such as `42-1.0`. | | status | string | yes | __Enum__ Filter by the EdgeWorker status, either `success`, `genericError`, `unknownEdgeWorkerId`, `unimplementedEventHandler`,… | | eventHandler | string | no | __Enum__ Filter EdgeWorkers by the event that triggers them, either `onClientRequest`, `onOriginRequest`, `onOriginResponse`,… | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### List resource tiers `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-resource-tiers` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | contractId | string | yes | Unique identifier of a contract. | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Create a secure token `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-secure-token` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | | body | object | yes | JSON request body | ### Get a secure token `GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-secure-token` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | propertyId | string | yes | Unique identifier for a property. | | acl | string | no | Path prefix of the response pages to debug. This value can be a pattern that matches multiple pages, and is explicitly part of the final… | | url | string | no | Exact path of the response pages to debug. This value is not explicitly part of the final token, but is used as a salt in the HMAC… | | expiry | integer | no | Number of minutes before the authentication token expires, from a minute to an hour. The default is 15. | | network | string | no | __Enum__ The network on which to use this authentication token, either `STAGING` or `PRODUCTION`. If not specified, the token is created… | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ### Validate an EdgeWorkers code bundle `POST https://www.apizie.tech/v1/cloud:akamai-edgeworkers/post-validations` (byok) | Parameter | Type | Required | Description | |---|---|---|---| | hostname | string | yes | Your API client's host from Akamai Control Center, for example https://akab-xxxx.luna.akamaiapis.net | | accountSwitchKey | string | no | For customers who manage more than one account, this [runs the operation from another… | ## Example ``` curl "https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-contracts" \ -H "x-api-key: $APIZIE_KEY" \ -H "x-upstream-key: $PROVIDER_KEY" ``` ## FAQ ### How do I call the Akamai EdgeWorkers API API? Create a free Apizie key, then send GET https://www.apizie.tech/v1/cloud:akamai-edgeworkers/get-contracts with the header x-api-key. Every endpoint returns { project, data, timestamp }. ### Is the Akamai EdgeWorkers API API free on Apizie? Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Akamai EdgeWorkers API itself also needs your own key from akamaiapis.net. ### Can AI agents use the Akamai EdgeWorkers API API? Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:akamai-edgeworkers. ### What is the status of the Akamai EdgeWorkers API API? Needs your own provider key (bring your own key)