Tags

Creates a Tag resource.

post

Creates a Tag resource.

Authorizations

Body

application/ld+jsonapplication/json

titlestring | nullRequired

backgroundColorstring | nullOptional

Background color of label

textColorstring | nullOptional

Text color of label

descriptionstring | nullOptional

Description of tag

Responses

201

Tag resource created

application/ld+jsonapplication/json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

post

HTTPcURLJavaScriptPython

POST /tags HTTP/1.1
Host: api.rogerroger.io
X-API-KEY: YOUR_API_KEY
Content-Type: application/ld+json
Accept: */*
Content-Length: 73

{
  "title": null,
  "backgroundColor": null,
  "textColor": null,
  "description": null
}

application/ld+jsonapplication/json

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

Retrieves a Tag resource.

get

Retrieves a Tag resource.

Authorizations

Path parameters

idstringRequired

Tag identifier

Responses

200

Tag resource

application/ld+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

get

HTTPcURLJavaScriptPython

GET /tags/{id} HTTP/1.1
Host: api.rogerroger.io
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

Updates the Tag resource.

patch

Updates the Tag resource.

Authorizations

Path parameters

idstringRequired

Tag identifier

Body

idstring | nullOptional

backgroundColorstring | nullOptional

textColorstring | nullOptional

titlestring | nullRequired

descriptionstring | nullOptional

createdAtstring | nullOptional

updatedAtstring | nullOptional

Responses

200

Tag resource updated

application/ld+jsonapplication/json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

patch

HTTPcURLJavaScriptPython

PATCH /tags/{id} HTTP/1.1
Host: api.rogerroger.io
X-API-KEY: YOUR_API_KEY
Content-Type: application/merge-patch+json
Accept: */*
Content-Length: 117

{
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

Replaces the Tag resource.

put

Replaces the Tag resource.

Authorizations

Path parameters

idstringRequired

Tag identifier

Body

application/ld+jsonapplication/json

@contextone ofRead-onlyOptional

stringOptional

or

@idstringRead-onlyOptional

@typestringRead-onlyOptional

idstring | nullOptional

backgroundColorstring | nullOptional

textColorstring | nullOptional

titlestring | nullRequired

descriptionstring | nullOptional

createdAtstring | nullOptional

updatedAtstring | nullOptional

Responses

200

Tag resource updated

application/ld+jsonapplication/json

400

Invalid input

application/ld+jsonapplication/problem+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

404

Not found

application/ld+jsonapplication/problem+jsonapplication/json

422

An error occurred

application/ld+jsonapplication/problem+jsonapplication/json

put

HTTPcURLJavaScriptPython

PUT /tags/{id} HTTP/1.1
Host: api.rogerroger.io
X-API-KEY: YOUR_API_KEY
Content-Type: application/ld+json
Accept: */*
Content-Length: 117

{
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

application/ld+jsonapplication/json

{
  "@context": "text",
  "@id": "text",
  "@type": "text",
  "id": null,
  "backgroundColor": null,
  "textColor": null,
  "title": null,
  "description": null,
  "createdAt": null,
  "updatedAt": null
}

Retrieves the collection of Tag resources.

get

Retrieves the collection of Tag resources.

Authorizations

Query parameters

pageintegerOptional

The collection page number

Default: 1

itemsPerPageinteger · max: 30Optional

The number of items per page

Default: 15

idstringOptional

id[]string[]Optional

Responses

200

Tag collection

application/ld+jsonapplication/json

403

Forbidden

application/ld+jsonapplication/problem+jsonapplication/json

get

HTTPcURLJavaScriptPython

GET /tags HTTP/1.1
Host: api.rogerroger.io
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "member": [
    {
      "@context": "text",
      "@id": "text",
      "@type": "text",
      "id": null,
      "backgroundColor": null,
      "textColor": null,
      "title": null,
      "description": null,
      "createdAt": null,
      "updatedAt": null
    }
  ],
  "totalItems": 1,
  "view": {
    "@id": "string",
    "type": "string",
    "first": "string",
    "last": "string",
    "previous": "string",
    "next": "string"
  },
  "search": {
    "@type": "text",
    "template": "text",
    "variableRepresentation": "text",
    "mapping": [
      {
        "@type": "text",
        "variable": "text",
        "property": null,
        "required": true
      }
    ]
  }
}