List Namespaces

Retrieve all namespaces for your account. Namespaces let you organize uploaded files into logical groups (like folders).

OverviewCopy Anchor Link

Namespaces help you organize your uploaded files into categories such as "Client Calls", "Product Demos", or "Training Videos". A default namespace is automatically created if you don't have any yet, and files without a namespace are lazily migrated to it.

Example RequestCopy Anchor Link

curl "https://api.vidnavigator.com/v1/namespaces" \
  -H "X-API-Key: YOUR_API_KEY"

Success ResponseCopy Anchor Link

{
  "status": "success",
  "data": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "name": "default",
      "created_at": "2025-01-10T08:00:00Z",
      "updated_at": "2025-01-10T08:00:00Z"
    },
    {
      "id": "64a1b2c3d4e5f6789abc0002",
      "name": "Client Calls",
      "created_at": "2025-02-15T14:30:00Z",
      "updated_at": "2025-02-15T14:30:00Z"
    }
  ]
}

API referenceCopy Anchor Link

curl -X GET 'https://api.vidnavigator.com/v1/namespaces'

{  "status": "success",  "data": [    {      "id": "string",      "_id": "string",      "user_id": "string",      "name": "string",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}