Akamai

Akamai: Image & Video Manager API

Akamai: Image & Video Manager API endpoints from Akamai

Developer tools#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Akamai: Image & Video Manager API endpoints from Akamai

Endpoints 21

Image collections

  • GETList image collections/imagecollections?limit={{limit}}&accountSwitchKey={{accountSwitchKey}}Lists all image collections, unless you set a limit.
  • PUTCreate a new image collection/imagecollections?accountSwitchKey={{accountSwitchKey}}Create a new image collection.
  • GETGet an image collection/imagecollections/:imageCollectionId?accountSwitchKey={{accountSwitchKey}}Returns the values for the image collection you specify.
  • POSTUpdate an image collection/imagecollections/:imageCollectionId?accountSwitchKey={{accountSwitchKey}}Update an image collection.
  • DELETERemove an image collection/imagecollections/:imageCollectionId?accountSwitchKey={{accountSwitchKey}}Delete a specific image collection.

Image collection hitory

  • GETGet image collection history/imagecollections/history/:imageCollectionId?limit={{limit}}&accountSwitchKey={{accountSwitchKey}}Get a history of a specific image collection and all updates to it over the last three months.

Errors

  • GETList error details/network/:network/details/errors?limit={{limit}}&url={{url}}&policyId={{policyId}}&size={{size}}&transformationType={{transformationType}}&accountSwitchKey={{accountSwitchKey}}Returns a list of image or video errors for the transformations requested in the past three days.

Logs

  • GETList log details/network/:network/details/logs?limit={{limit}}&url={{url}}&policyId={{policyId}}&size={{size}}&transformationType={{transformationType}}&accountSwitchKey={{accountSwitchKey}}Returns a list of image or video logs for the transformations requested in the past three days.

Images

  • GETList images/network/:network/images?limit={{limit}}&url={{url}}&policyId={{policyId}}&accountSwitchKey={{accountSwitchKey}}List a policy's images.
  • GETGet an image/network/:network/images/:imageId?accountSwitchKey={{accountSwitchKey}}Returns a specific image.

Policies

  • GETList policies/network/:network/policies?accountSwitchKey={{accountSwitchKey}}Returns a list of all policies belonging to the specified policy set.
  • PUTRoll back a policy/network/:network/policies/rollback/:policyId?accountSwitchKey={{accountSwitchKey}}Use this operation to revert the previous version of the policy and deploy it to the network. Use this operation to stop and reverse a policy rollout.
  • GETGet a policy/network/:network/policies/:policyId?accountSwitchKey={{accountSwitchKey}}Returns a specific policy assigned to the specified policy set.
  • PUTCreate or modify a policy/network/:network/policies/:policyId?accountSwitchKey={{accountSwitchKey}}Run this operation to update an existing policy or create a new policy. Run the List policies operation to get the list of existing policies and their policy…
  • DELETERemove a policy/network/:network/policies/:policyId?accountSwitchKey={{accountSwitchKey}}Delete a specific policy.

Policy history

  • GETGet policy history/network/:network/policies/history/:policyId?accountSwitchKey={{accountSwitchKey}}Returns the policy history by policy ID. This operation returns the full state of the policy at various points in time. Time stamps are in ISO 8601 extended…

Policy sets

  • GETList policy sets/policysets?accountSwitchKey={{accountSwitchKey}}Returns a list of all policy sets for a contract in production.
  • POSTCreate a policy set/policysets?accountSwitchKey={{accountSwitchKey}}Create a new policy set for the contract on both networks.
  • GETGet a policy set/policysets/:policySetId?accountSwitchKey={{accountSwitchKey}}View details for a specific policy set in production.
  • PUTUpdate a policy set/policysets/:policySetId?accountSwitchKey={{accountSwitchKey}}Update the name or region of an existing policy set on both networks.
  • DELETEDelete a policy set/policysets/:policySetId?accountSwitchKey={{accountSwitchKey}}Delete a policy set from a contract on both networks.

API details

Base URL
https://{hostname}/imaging/v2
Authentication
None declared in the description
Operations
21 operations on 13 pathsGET 12PUT 4DELETE 3POST 2
Main resources
Image collections 5Policies 5Policy sets 5Images 2Errors 1Image collection hitory 1Logs 1Policy history 1
Response formats
application/json application/problem+json */*
Description format
OpenAPI 3.0.0, API version 2

How to test the Akamai: Image & Video Manager API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Akamai: Image & Video Manager API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “List image collections” (GET /imagecollections?limit={{limit}}&accountSwitchKey={{accountSwitchKey}}), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Akamai: Image & Video Manager API?

Akamai: Image & Video Manager API endpoints from Akamai It is listed under Developer tools and has 21 endpoints.

Who publishes the Akamai: Image & Video Manager API?

It is listed from Akamai's public API description (an OpenAPI document), not published by Akamai on Swastik Codes. Anyone who controls akamai.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Akamai: Image & Video Manager API?

Requests go to https://{hostname}/imaging/v2. Endpoint paths are added to this base URL.

How do I authenticate with the Akamai: Image & Video Manager API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Akamai: Image & Video Manager API have?

21 operations on 13 paths (12 GET, 4 PUT, 3 DELETE, 2 POST). The largest groups are Image collections, Policies, Policy sets, Images.

Is forking the Akamai: Image & Video Manager API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.