Hello World

Let's make your first API call to Duro. This guide will walk you through a simple query to verify your setup.

Prerequisites

Before making API calls, ensure you have:

• An API key (see Authentication)

• Your organization slug (visible in your Duro URL: durohub.com/org/@your-org/...)

Required Headers

All API requests require these headers:

Header	Description
x-api-key	Your API authentication token
x-organization	Your organization slug (e.g., @acme-corp)
Content-Type	Must be application/json

For library-scoped operations (like querying components), you'll also need the x-library header. See the API v2 Migration Guide for details.

Your First Query

Here's a simple query to list all libraries in your organization:

query GetLibraries {
  libraries {
    id
    name
    slug
    description
  }
}

Example Response

{
  "data": {
    "libraries": [
      {
        "id": "fc28b204-0cd0-46b3-96eb-b0720c16c423",
        "name": "Main Library",
        "slug": "main-library",
        "description": "Primary component library"
      }
    ]
  }
}

Complete cURL Example

Here's a complete example using cURL:

curl 'https://api.durohub.com/graphql' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'x-organization: @your-org' \
  -H 'Content-Type: application/json' \
  -d '{"query": "query { libraries { id name slug } }"}'

Next Steps

Now that you've verified your API access, learn about working with Components.