API Versions

GET /metadata/api_versions

Retrieve the list of versions for Arta's API.

A version may be passed along in API calls as an arta-version request header to target a specific API version.

Additionally, you may set a default API version on your Organization to fallback to a particular version.

Headers

  • Authorization string Required

    Authorize your API calls with an Arta API token

Responses

  • • 200 application/json

    A collection of API Versions

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • description string

      A long form description

    • authentication array[string]

      The list of authentication schema supported by this API version

    • id string

      The ID representing the resource

    • status string

      Indicates whether the API version is active, beta, or deprecated
GET /metadata/api_versions 
curl \
 -X GET https://api.arta.io/metadata/api_versions \
 -H "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y"
Response examples (200) 
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
[
  {
    "description": "A key-authenticated API Version released on October 22, 2020.",
    "authentication": [
      "api_key"
    ],
    "id": "2020-10-22",
    "status": "active"
  }
]