# Release tag

## Get all tags by release commit

> \## Release tag Resource Fields\
> \
> \| Field |\
> \| :--- |\
> \| \`id\` |\
> \| \`release\` |\
> \| \`tag\_key\` |\
> \| \`value\` |\
> \
> \
> \---\
> \
> \`GET /v7/release\_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/release_tag":{"get":{"tags":["Release tag"],"summary":"Get all tags by release commit","description":"## Release tag Resource Fields\n\n| Field |\n| :--- |\n| `id` |\n| `release` |\n| `tag_key` |\n| `value` |\n\n\n---\n\n`GET /v7/release_tag`"}}}}
```

## Create a new release tag

> \`POST /v7/release\_tag\`\
> \
> \*\*Request Body:\*\*\
> \`\`\`json\
> {\
> &#x20;   "release": \<RELEASE 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/release_tag":{"post":{"tags":["Release tag"],"summary":"Create a new release tag","description":"`POST /v7/release_tag`\n\n**Request Body:**\n```json\n{\n    \"release\": <RELEASE ID>,\n    \"tag_key\": <KEY>,\n    \"value\": <VALUE>\n}\n```","requestBody":{"content":{"application/json":{"schema":{"type":"object"}}}}}}}}
````