1. Create
POST api/v1/agents/
For example, a k8s has been started in advance, and an agent is configured to connect to it. Then we register the agent's API URL to Cello.
Body Parameters | Type | Note |
---|---|---|
name | string | |
type | string | |
urls | string |
Example Request Body
Code Block |
---|
{ "name": "cello-agent-docker", "type": "docker", "urls": "http://cello.docker.agent:5001" } |
...
Code Block |
---|
{ "data": { "id": "64b4b978-03e7-4bcc-b0f7-4601eed71e47" }, "msg": null, "status": "successful" } |
2. List
GET api/v1/agents/
List all agents with criteria
Body Parameters | Type | Note |
---|---|---|
id | UUID | |
name | string | |
status | string | |
create_at | date | |
type | string | |
urls | string | |
organization | UUID |
Example Response Body
Code Block |
---|
{
"data": {
"total": 1,
"data": [
{
"id": "fe910cd9-e8fe-4af1-a184-077da69f36e0",
"name": "cello-agent-docker",
"status": "active",
"created_at": "2021-12-17T02:44:48.006079Z",
"type": "docker",
"urls": "http://cello.docker.agent:5001",
"organization": "c09e3be4-3bd4-4ae3-8b27-7e8e56c853de"
}
]
},
"msg": null,
"status": "successful"
}
|
3. Retrieve
GET api/v1/agents/{id}/
Retrieve an message of the agent with id
Path Parameters | Type | Note |
---|---|---|
id | UUID | agent id |
Example Respone Body
Code Block |
---|
{ "data": { "id": "64b4b978-03e7-4bcc-b0f7-4601eed71e47", "name": "cello-agent-docker", "status": "active", "created_at": "2021-12-10T05:51:01.420669Z", "type": "docker", "organization_id": "76ebf68b-019f-45ff-abef-67e3a3d1752f" }, "msg": null, "status": "successful" } |
4. Update
PUTapi/v1/agents/{id}/
Update an agent with the id
Path Parameters | Type | Note |
---|---|---|
id | UUID | agent id |
Body Parameters | Type | Note |
---|---|---|
name | string |
Example Requet Body
Code Block |
---|
{ "name": "test" } |
Example Response Body
Code Block |
---|
{
"data": null,
"msg": null,
"status": "successful"
}
|
5. Delete
DELETE api/v1/agents/{id}/
Delete the agent with the given id.
Path Parameters | Type | Note |
---|---|---|
id | UUID | agent id |