API Explorer

Test and explore Tags API endpoints directly from your browser. Try our interactive API playground to build and test API calls in real-time.

Interactive API Sandbox

Authentication


// Set your API key here
curl -X GET 'https://api.tags.com/v3/tags' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Use your API key as Bearer token in the Authorization header for all requests.

Available Endpoints

GET
/api/v3/tags

Retrieve a list of all available tags for the authenticated user.


curl -X GET 'https://api.tags.com/v3/tags' \
  -H 'Authorization: Bearer YOUR_API_KEY'

POST
/api/v3/tags

Create a new tag with specified name and metadata.


curl -X POST 'https://api.tags.com/v3/tags' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name": "urgent", "type": "work"}'

PUT
/api/v3/tags/:id

Update an existing tag by its ID.


curl -X PUT 'https://api.tags.com/v3/tags/5z98f1' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"enabled": false}'

DELETE
/api/v3/tags/:id

Delete a tag by its ID.


curl -X DELETE 'https://api.tags.com/v3/tags/5z98f1' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Common Status Codes

200 OK

Request succeeded.

400 Bad Request

Invalid request format.

401 Unauthorized

Authentication credentials are missing.

404 Not Found

Resource not found.

Ready to Test the API?

Try out the API explorer and see how powerful Tags API can be for your project.