Tags

Get all tags for a store

GEThttps://api.paynow.gg/v1/stores/{storeId}/tags

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

Response

200OKTagDto[]

Show fields

created_atstringRequired

When the tag was created

created_byActorDtoRequired

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

enabledbooleanRequired

Indicates whether this tag is enabled.

idFlakeIdRequired

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

store_idFlakeIdRequired

descriptionstringOptional

The description of the tag.

image_urlstringOptional

The Image URL associated with the tag.

updated_atstringOptional

When the tag was last updated.

updated_byActorDtoOptional

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/tags" \
  -H "Authorization: APIKey TOKEN"

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

const result = await paynow.tags.getTags();

import requests

headers = {"Authorization": "APIKey TOKEN"}
response = requests.get("https://api.paynow.gg/v1/stores/{storeId}/tags", headers=headers)

Response200

[
  {
    "created_at": "2024-01-01T00:00:00Z",
    "created_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    },
    "enabled": true,
    "id": "411486491630370816",
    "name": "string",
    "slug": "string",
    "store_id": "411486491630370816",
    "description": "string",
    "image_url": "string",
    "updated_at": "2024-01-01T00:00:00Z",
    "updated_by": {
      "type": "anonymous",
      "id": "411486491630370816"
    }
  }
]

Create a new tag

POSThttps://api.paynow.gg/v1/stores/{storeId}/tags

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

Request body

descriptionstringOptional

enabledbooleanOptional

namestringOptional

slugstringOptional

Response

200OKTagDto

Show fields

created_atstringRequired

When the tag was created

created_byActorDtoRequired

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

enabledbooleanRequired

Indicates whether this tag is enabled.

idFlakeIdRequired

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

store_idFlakeIdRequired

descriptionstringOptional

The description of the tag.

image_urlstringOptional

The Image URL associated with the tag.

updated_atstringOptional

When the tag was last updated.

updated_byActorDtoOptional

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X POST "https://api.paynow.gg/v1/stores/{storeId}/tags" \
  -H "Authorization: APIKey TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "slug": "string",
  "description": "string",
  "enabled": true
}'

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

const result = await paynow.tags.createTag({
  name: "string",
  slug: "string",
  description: "string",
  enabled: true,
});

import requests

headers = {"Authorization": "APIKey TOKEN"}
payload = {
    "name": "string",
    "slug": "string",
    "description": "string",
    "enabled": True,
}
response = requests.post("https://api.paynow.gg/v1/stores/{storeId}/tags", headers=headers, json=payload)

Response200

{
  "created_at": "2024-01-01T00:00:00Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "enabled": true,
  "id": "411486491630370816",
  "name": "string",
  "slug": "string",
  "store_id": "411486491630370816",
  "description": "string",
  "image_url": "string",
  "updated_at": "2024-01-01T00:00:00Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Get a tag by an ID

GEThttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Response

200OKTagDto

Show fields

created_atstringRequired

When the tag was created

created_byActorDtoRequired

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

enabledbooleanRequired

Indicates whether this tag is enabled.

idFlakeIdRequired

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

store_idFlakeIdRequired

descriptionstringOptional

The description of the tag.

image_urlstringOptional

The Image URL associated with the tag.

updated_atstringOptional

When the tag was last updated.

updated_byActorDtoOptional

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}" \
  -H "Authorization: APIKey TOKEN"

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

const result = await paynow.tags.getTag("411486491630370816");

import requests

headers = {"Authorization": "APIKey TOKEN"}
response = requests.get("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}", headers=headers)

Response200

{
  "created_at": "2024-01-01T00:00:00Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "enabled": true,
  "id": "411486491630370816",
  "name": "string",
  "slug": "string",
  "store_id": "411486491630370816",
  "description": "string",
  "image_url": "string",
  "updated_at": "2024-01-01T00:00:00Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Update a tag by ID

PATCHhttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Request body

descriptionstringOptional

enabledbooleanOptional

namestringOptional

slugstringOptional

Response

200OKTagDto

Show fields

created_atstringRequired

When the tag was created

created_byActorDtoRequired

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

enabledbooleanRequired

Indicates whether this tag is enabled.

idFlakeIdRequired

namestringRequired

The unique name for the tag.

slugstringRequired

The unique slug for the tag.

store_idFlakeIdRequired

descriptionstringOptional

The description of the tag.

image_urlstringOptional

The Image URL associated with the tag.

updated_atstringOptional

When the tag was last updated.

updated_byActorDtoOptional

typeenumRequired

Possible enum values

anonymous
user
api_key
customer
game_server
internal
admin
platform
global_customer

idFlakeIdOptional

Failed requests return a PayNowError body. See the error response guide.

curl -X PATCH "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}" \
  -H "Authorization: APIKey TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "slug": "string",
  "description": "string",
  "enabled": true
}'

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

const result = await paynow.tags.updateTag("411486491630370816", {
  name: "string",
  slug: "string",
  description: "string",
  enabled: true,
});

import requests

headers = {"Authorization": "APIKey TOKEN"}
payload = {
    "name": "string",
    "slug": "string",
    "description": "string",
    "enabled": True,
}
response = requests.patch("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}", headers=headers, json=payload)

Response200

{
  "created_at": "2024-01-01T00:00:00Z",
  "created_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  },
  "enabled": true,
  "id": "411486491630370816",
  "name": "string",
  "slug": "string",
  "store_id": "411486491630370816",
  "description": "string",
  "image_url": "string",
  "updated_at": "2024-01-01T00:00:00Z",
  "updated_by": {
    "type": "anonymous",
    "id": "411486491630370816"
  }
}

Delete a tag by ID

DELETEhttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Response

204No Content

Failed requests return a PayNowError body. See the error response guide.

curl -X DELETE "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}" \
  -H "Authorization: APIKey TOKEN"

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

await paynow.tags.deleteTag("411486491630370816");

import requests

headers = {"Authorization": "APIKey TOKEN"}
response = requests.delete("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}", headers=headers)

Get upload URL for tag image

GEThttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-url

Gets a pre-signed upload URL for uploading an image to a tag

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Response

200OKGetTagImageUploadUrlResponseDto

Show fields

idstringRequired

The ID of the direct image upload URL.

upload_urlstringRequired

The URL to upload the image to.

Failed requests return a PayNowError body. See the error response guide.

curl -X GET "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-url" \
  -H "Authorization: APIKey TOKEN"

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

const result = await paynow.tags.getTagImageUploadUrl("411486491630370816");

import requests

headers = {"Authorization": "APIKey TOKEN"}
response = requests.get("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-url", headers=headers)

Response200

{
  "id": "string",
  "upload_url": "string"
}

Finish tag image upload

POSThttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-finish

Finishes an image upload for a tag

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Request body

image_idstringRequired

The ID of the uploaded image returned by the server.

Response

204No Content

Failed requests return a PayNowError body. See the error response guide.

curl -X POST "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-finish" \
  -H "Authorization: APIKey TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "image_id": "string"
}'

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

await paynow.tags.finishTagImageUpload("411486491630370816", {
  image_id: "string",
});

import requests

headers = {"Authorization": "APIKey TOKEN"}
payload = {
    "image_id": "string",
}
response = requests.post("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image-upload-finish", headers=headers, json=payload)

Delete tag image

DELETEhttps://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image

Deletes an image for a tag

Headers

AuthorizationAPI KeyRequired

Authentication token for this request, sent as Authorization: APIKey TOKEN.

Path parameters

storeIdFlakeIdRequired

tagIdFlakeIdRequired

Response

204No Content

Failed requests return a PayNowError body. See the error response guide.

curl -X DELETE "https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image" \
  -H "Authorization: APIKey TOKEN"

import { createManagementClient } from "@paynow-gg/typescript-sdk";

const paynow = createManagementClient({
  apiKey: "API_KEY",
  storeId: "STORE_ID",
});

await paynow.tags.deleteTagImage("411486491630370816");

import requests

headers = {"Authorization": "APIKey TOKEN"}
response = requests.delete("https://api.paynow.gg/v1/stores/{storeId}/tags/{tagId}/image", headers=headers)