Collection Item
This endpoint is used to manager collection item for a collection inside the organization
Entity fields:
data.type
string
Should be "step"
data.attributes.category
string
Collection description
data.attributes.description
string
Collection name
data.attributes.hcl
int
Collection priority
data.attribute.key
string
Collection item name
data.attributes.value
string
Collection item value
data.attributes.s
ensitive
boolean
Values is sensitive
Example
POST /api/v1/organization/${ORGANIZATION_ID}/collection/"${COLLECTION_ID}/item/
{
"data": {
"type": "item",
"attributes": {
"category": "ENV",
"description": "random_description",
"hcl": false,
"key": "random_key",
"sensitive": true
}
}
Supported Operations
Returns the relationship item
organization Identifier
collection Identifier
Filters the collection of item using a 'disjoint' RSQL expression
Number of pages to return. Can be used with page[size]
Number of elements per page. Can be used with page[number]
Offset from 0 to start paginating. Can be used with page[limit]
Maximum number of items to return. Can be used with page[offset]
For requesting total pages/records be included in the response page meta data
Successful response
GET /api/v1/organization/{organizationId}/collection/{collectionId}/item HTTP/1.1
Host:
Accept: */*
Successful response
{
"data": [
{
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"collection": {
"data": [
null
]
}
}
}
],
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}
Creates an item of type item and adds it to item
organization Identifier
collection Identifier
Successful response
POST /api/v1/organization/{organizationId}/collection/{collectionId}/item HTTP/1.1
Host:
Content-Type: application/vnd.api+json
Accept: */*
Content-Length: 261
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"collection": {
"data": [
null
]
}
}
},
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}
Successful response
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"collection": {
"data": [
null
]
}
}
},
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}
Returns an instance of type item
organization Identifier
collection Identifier
item Identifier
Successful response
GET /api/v1/organization/{organizationId}/collection/{collectionId}/item/{itemId} HTTP/1.1
Host:
Accept: */*
Successful response
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"collection": {
"data": [
null
]
}
}
},
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}
Deletes an instance of type item
organization Identifier
collection Identifier
item Identifier
Successful response
DELETE /api/v1/organization/{organizationId}/collection/{collectionId}/item/{itemId} HTTP/1.1
Host:
Accept: */*
Successful response
No content
Modifies an instance of type item
organization Identifier
collection Identifier
item Identifier
Successful response
PATCH /api/v1/organization/{organizationId}/collection/{collectionId}/item/{itemId} HTTP/1.1
Host:
Content-Type: application/vnd.api+json
Accept: */*
Content-Length: 261
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"collection": {
"data": [
null
]
}
}
},
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}
Successful response
No content
Last updated
Was this helpful?