Authentication

Generate an API key and use it to authenticate your requests.
A Ditto API key is required to access the API. API keys are created at the level of a workspace, and can be managed by anyone who has edit access permissions.

Generate an API key

  1. 1.
    Log into Ditto and navigate to the Developer Integrations page.
  2. 2.
    Enable developer integrations for your workspace if they haven't been enabled already (see this page for more information).
Ditto behavior as it relates to development can be managed from the Developer Integrations page.
  1. 3.
    Under the section titled API Keys, click + Create API key.
A new API Key can be created by clicking the "Create API Key" button
  1. 4.
    Enter a name for the API key and click Create.
  2. 5.
    Copy the value of the API key to your clipboard and store it somewhere safe. You won't be able to access the full value of the API Key again after closing the modal.

Authenticate your requests

Authorize your requests by passing an API key in an Authorization header as follows:
"Authorization": "token <YOUR_API_KEY>"
Here's an example request to the /components endpoint:
curl -X GET \
--header "Authorization: token <YOUR_API_KEY>" \
"https://api.dittowords.com/v1/components"
Last modified 11d ago