# Basic questions about Wazo API, Agents and Queues

**URL:** <https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696>\
**Category:** Development: API/Events\
**Created:** [September 1, 2025, 5:02pm UTC](https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696 "2025-09-01T17:02:28Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![WindForce](https://avatars.discourse-cdn.com/v4/letter/w/bbe5ce/32.png) [@WindForce](https://wazo-platform.discourse.group/u/WindForce)\
**Post date:** [September 1, 2025, 5:02pm UTC](https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696/1 "2025-09-01T17:02:28Z")

</div>

Hi.

Installed Wazo yesterday and am delighted and overwhelmed about this product and it’s possibilities.

Alas, i am struggling with some basic api calls.

I used the ui to create users and queues. Also created an Agent but the ui doesn’t let me connect it to the user. I am currently building an Agent’s Toolbar where i want the Agents to login, be presented with their queues, and give them buttons to select which queues to login to ( also break etc… )

1. associating user with agent: read here in the forum i need to call whats explained here: [https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/associate\_user\_agent](https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/associate_user_agent) but i don’t see a request sample, tried something like :

curl -k -X PUT -H “X-Auth-Token: 312ea714-ab2d-4390-80a7-1910b01d9bfa” [https://192.168.10.20/api/confd/1.1/users/312ea714-ab2d-4390-80a7-1910b01d9bfa/agents/312ea714-ab2d-4390-80a7-1910b01d9bfa](https://192.168.10.20/api/confd/1.1/users/312ea714-ab2d-4390-80a7-1910b01d9bfa/agents/312ea714-ab2d-4390-80a7-1910b01d9bfa) ( this is the user uuid and the agent uuid ) but it gives error URL not found , how can i call it correctly?

1. How can i list a list of queues where this agent or user is member?
2. Is it possible to have the agent login/logout just from one specific queue?

Thank you in advance! Vous pouvez repondre en francais aussi 🙂

Jaime

---

<div class="post-metadata">

**Author:** ![julienfr](https://yyz2.discourse-cdn.com/free1/user_avatar/wazo-platform.discourse.group/julienfr/32/797_2.png) [@julienfr](https://wazo-platform.discourse.group/u/julienfr)\
**Post date:** [September 2, 2025, 7:02am UTC](https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696/2 "2025-09-02T07:02:51Z")

</div>

Hi,

here some details:

1. 

you need the id of the user and agent, not the uuid

should looks more like  
`https://192.168.10.20/api/confd/1.1/users/2/agents/1`

1. 

You can retreive this information in the queue details, looks like:  
`members {`  
` agents: [],`  
` users: []`  
`} `

1. 

not rigth now, but it is planning with no more information than this:

 ![image](https://global.discourse-cdn.com/free1/uploads/wazo_platform/original/1X/32bec1126986e24104a8d8d137fd5c17482f06a3.png)

You can try my app:

> **[Toriphone Admin](https://admin.toriphone.fr/)**

> **[ToriPhone desktop](https://app.toriphone.fr/)**

i want to make it open-source if i got some financial help. i’ll do a crownfounding soon.

wazo-ui is a minimal web application for test and discover, but i don’t recommend it for production.

for example, if your user is a agent, and you delete this user, the agent will stay associated with an unexisting user, so you will not be able to delete or modify this agent.

cheers

---

<div class="post-metadata">

**Author:** ![WindForce](https://avatars.discourse-cdn.com/v4/letter/w/bbe5ce/32.png) [@WindForce](https://wazo-platform.discourse.group/u/WindForce)\
**Post date:** [September 2, 2025, 1:12pm UTC](https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696/3 "2025-09-02T13:12:55Z")

</div>

Merci Julien!

1. so i should list all queues, then check one by one members? what functions do i have to call
2. that’s from yesterday? lol!

Many thanks for your help!

Jaime

---

<div class="post-metadata">

**Author:** ![julienfr](https://yyz2.discourse-cdn.com/free1/user_avatar/wazo-platform.discourse.group/julienfr/32/797_2.png) [@julienfr](https://wazo-platform.discourse.group/u/julienfr)\
**Post date:** [September 3, 2025, 7:25am UTC](https://wazo-platform.discourse.group/t/basic-questions-about-wazo-api-agents-and-queues/1696/4 "2025-09-03T07:25:24Z")

</div>

sorry, i missunderstood.

[https://api.wazo.io/documentation/api/configuration.html#tag/users/operation/get\_user](https://api.wazo.io/documentation/api/configuration.html#tag/users/operation/get_user)

or

[https://api.wazo.io/documentation/api/configuration.html#tag/users/operation/list\_user](https://api.wazo.io/documentation/api/configuration.html#tag/users/operation/list_user)

here you can have the detail of an user, and informations about his groups, switchboards, queues.

if you have user.queues.[  
{something},  
{else}  
]  
that means he is member of this queue,

if you want to know about agent, you must request

[https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/get\_agent](https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/get_agent)

or

[https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/list\_agents](https://api.wazo.io/documentation/api/configuration.html#tag/agents/operation/list_agents)

with both api calls, you can then have all users and agents  
you can so make this table easily:

 ![image](https://global.discourse-cdn.com/free1/uploads/wazo_platform/original/1X/4be763d450bb6cf3ff082cda0f51da093215036e.png)

As you see, i list queues where my user is agent.

cheers