# Fleet tag

## Get all tags by fleet name

> \## Fleet tag Resource Fields\
> \
> \| Field |\
> \| :--- |\
> \| \`id\` |\
> \| \`application\` |\
> \| \`tag\_key\` |\
> \| \`value\` |\
> \
> \
> \---\
> \
> \`GET /v7/application\_tag\`

```json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/application_tag":{"get":{"tags":["Fleet tag"],"summary":"Get all tags by fleet name","description":"## Fleet tag Resource Fields\n\n| Field |\n| :--- |\n| `id` |\n| `application` |\n| `tag_key` |\n| `value` |\n\n\n---\n\n`GET /v7/application_tag`"}}}}
```

## Create a new fleet tag

> \`POST /v7/application\_tag\`\
> \
> \*\*Request Body:\*\*\
> \`\`\`json\
> {\
> &#x20;   "application": \<FLEET ID>,\
> &#x20;   "tag\_key": \<KEY>,\
> &#x20;   "value": \<VALUE>\
> }\
> \`\`\`

````json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/application_tag":{"post":{"tags":["Fleet tag"],"summary":"Create a new fleet tag","description":"`POST /v7/application_tag`\n\n**Request Body:**\n```json\n{\n    \"application\": <FLEET ID>,\n    \"tag_key\": <KEY>,\n    \"value\": <VALUE>\n}\n```","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}}}}}}
````

## Delete a fleet tag

> \`DELETE /v7/application\_tag/(\<ID>)\`

```json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/application_tag/({ID})":{"delete":{"tags":["Fleet tag"],"summary":"Delete a fleet tag","description":"`DELETE /v7/application_tag/(<ID>)`","parameters":[{"name":"ID","in":"path","required":true}]}}}}
```

## Update a fleet tag

> \`PATCH /v7/application\_tag/(\<ID>)\`\
> \
> \*\*Request Body:\*\*\
> \`\`\`json\
> {\
> &#x20;   "value": \<NEW VALUE>\
> }\
> \`\`\`

````json
{"openapi":"3.0.0","info":{"title":"Balena API Spec","version":"7.0.0"},"servers":[{"url":"https://api.balena-cloud.com"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v7/application_tag/({ID})":{"patch":{"tags":["Fleet tag"],"summary":"Update a fleet tag","description":"`PATCH /v7/application_tag/(<ID>)`\n\n**Request Body:**\n```json\n{\n    \"value\": <NEW VALUE>\n}\n```","parameters":[{"name":"ID","in":"path","required":true}],"requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}}}}}}
````