Tags

Tag customers to better organize your data.

Retrieve a list of tags

Retrieve a list of tags.

Request
Security:
query Parameters
limit
integer [ 0 .. 1000 ]

The collection items limit.

offset
integer >= 0

The collection items offset.

filter
string

The collection items filter requires a special format. Use "," for multiple allowed values. Use ";" for multiple fields. See the filter guide for more options and examples about this format.

q
string

The partial search of the text fields.

sort
Array of strings

The collection items sort field and order (prefix with "-" for descending sort).

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Responses
200

A list of tags was retrieved successfully.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

get/tags
Request samples
curl -i -X GET \
  'https://api-sandbox.rebilly.com/organizations/unknown/tags?limit=1000&offset=0&filter=string&q=string&sort=string' \
  -H 'Organization-Id: 4f6cf35x-2c4y-483z-a0a9-158621f77a21' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'
Response samples
application/json
[
  • {
    }
]

Create a tag

Create a tag.

Request
Security:
header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Request Body schema: application/json

Tag resource.

name
required
string <= 255 characters ^[@~\-\.\w\s]+$

The tag is unique name, which is case-insensitive.

Responses
201

Tag was created.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

409

Conflict.

422

Invalid data was sent.

post/tags
Request samples
application/json
{
  • "name": "New"
}
Response samples
application/json
{
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "name": "New",
  • "createdTime": "2019-08-24T14:15:22Z",
  • "updatedTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}

Retrieve a tag

Retrieve a tag.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Responses
200

Tag with specified name was retrieved successfully.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

404

Resource was not found.

get/tags/{tag}
Request samples
curl -i -X GET \
  https://api-sandbox.rebilly.com/organizations/unknown/tags/:tag \
  -H 'Organization-Id: 4f6cf35x-2c4y-483z-a0a9-158621f77a21' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "name": "New",
  • "createdTime": "2019-08-24T14:15:22Z",
  • "updatedTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}

Update a tag

Update a tag.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Request Body schema: application/json

Tag resource.

name
required
string <= 255 characters ^[@~\-\.\w\s]+$

The tag is unique name, which is case-insensitive.

Responses
200

Tag was updated.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

404

Resource was not found.

409

Conflict.

422

Invalid data was sent.

patch/tags/{tag}
Request samples
application/json
{
  • "name": "New"
}
Response samples
application/json
{
  • "id": "4f6cf35x-2c4y-483z-a0a9-158621f77a21",
  • "name": "New",
  • "createdTime": "2019-08-24T14:15:22Z",
  • "updatedTime": "2019-08-24T14:15:22Z",
  • "_links": [
    ]
}

Delete a tag

Delete a tag. It's an asynchronous operation.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Responses
204

Tag was deleted.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

404

Resource was not found.

delete/tags/{tag}
Request samples
curl -i -X DELETE \
  https://api-sandbox.rebilly.com/organizations/unknown/tags/:tag \
  -H 'Organization-Id: 4f6cf35x-2c4y-483z-a0a9-158621f77a21' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "status": 400,
  • "title": "string",
  • "detail": "string",
  • "error": "string"
}

Tag a list of customers

Tag a list of customers. If the customer from the list is already tagged it will be ignored. It's an asynchronous operation.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Request Body schema: application/json
customerIds
required
Array of strings [ 1 .. 1000 ] items

The list of customer IDs.

Responses
204

Customers was tagged.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

422

Invalid data was sent.

post/tags/{tag}/customers
Request samples
application/json
{
  • "customerIds": [
    ]
}
Response samples
application/json
{
  • "status": 400,
  • "title": "string",
  • "detail": "string",
  • "error": "string"
}

Untag a list of customers

Untag a list of customers. If the customer from the list is already untagged it will be ignored. It's an asynchronous operation.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Request Body schema: application/json
customerIds
required
Array of strings [ 1 .. 1000 ] items

The list of customer IDs.

Responses
204

Customers was untagged.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

422

Invalid data was sent.

delete/tags/{tag}/customers
Request samples
application/json
{
  • "customerIds": [
    ]
}
Response samples
application/json
{
  • "status": 400,
  • "title": "string",
  • "detail": "string",
  • "error": "string"
}

Tag a customer

Tag a customer.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

customerId
required
string <= 50 characters ^[@~\-\.\w]+$

The customer identifier string.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Responses
204

Customer was tagged.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

404

Resource was not found.

post/tags/{tag}/customers/{customerId}
Request samples
curl -i -X POST \
  https://api-sandbox.rebilly.com/organizations/unknown/tags/:tag/customers/:customerId \
  -H 'Organization-Id: 4f6cf35x-2c4y-483z-a0a9-158621f77a21' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "status": 400,
  • "title": "string",
  • "detail": "string",
  • "error": "string"
}

Untag a customer

Untag a customer.

Request
Security:
path Parameters
tag
required
string^[@~\-\.\w\s]+$

The tag name.

customerId
required
string <= 50 characters ^[@~\-\.\w]+$

The customer identifier string.

header Parameters
Organization-Id
string (ResourceId) <= 50 characters
Deprecated

Organization identifier in scope of which need to perform request (if not specified, the default organization will be used).

It is deprecated. Use servers with /organizations/{organizationId} base path instead.

Example: 4f6cf35x-2c4y-483z-a0a9-158621f77a21
Responses
204

Customer was untagged.

401

Unauthorized access, invalid credentials was used.

403

Access forbidden.

404

Resource was not found.

delete/tags/{tag}/customers/{customerId}
Request samples
curl -i -X DELETE \
  https://api-sandbox.rebilly.com/organizations/unknown/tags/:tag/customers/:customerId \
  -H 'Organization-Id: 4f6cf35x-2c4y-483z-a0a9-158621f77a21' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'
Response samples
application/json
{
  • "status": 400,
  • "title": "string",
  • "detail": "string",
  • "error": "string"
}