# Namespaces

## Reference

- v4 API:

  - `gitlab.v4.objects.Namespace`

  - `gitlab.v4.objects.NamespaceManager`

  - `gitlab.Gitlab.namespaces`

- GitLab API: https://docs.gitlab.com/api/namespaces

## Examples

List namespaces:

    namespaces = gl.namespaces.list(get_all=True)

Search namespaces:

    namespaces = gl.namespaces.list(search='foo', get_all=True)

Get a namespace by ID or path:

    namespace = gl.namespaces.get("my-namespace")

Get existence of a namespace by path:

    namespace = gl.namespaces.exists("new-namespace")

    if namespace.exists:
        # get suggestions of namespaces that don't already exist
        print(namespace.suggests)