gatego API documentation

Create or update a tag

PUT /api/tag

Tries to find a tag by name and if found, it will update it, otherwise it will create it a new one

Headers

X-Gatego-oid

Specify effective organization_id for Admin and Group Organization Admins. This is a global header for all endpoints only taken into consideration when it makes sense (it won't be used in Auth, for example)

application/json

Body

color string
name string Required

Responses

• 200

OK
Hide response attributes Show response attributes object
- color string
- created_at string(date-time)
- id integer(int64)
- last_modified_at string(date-time)
- name string
• 201

Created
• 401

Unauthorized
• 403

Forbidden
• 404

Not Found

PUT /api/tag

curl \
 -X PUT https://api-dev.gatego.io:443/api/tag \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"color":"string","name":"string"}'

Request example

# Headers

# Payload
{
  "color": "string",
  "name": "string"
}

Response examples (200)

{
  "color": "string",
  "created_at": "2023-05-04T09:42:00+00:00",
  "id": 42,
  "last_modified_at": "2023-05-04T09:42:00+00:00",
  "name": "string"
}